Примечание: Редактор github.dev в настоящее время находится в бета-версии предварительной версии. Вы можете оставить отзыв в наших обсуждениях.
Сведения о редакторе github.dev
Редактор github.dev предоставляет упрощенный интерфейс редактирования, который полностью выполняется в браузере. С помощью редактора github.dev можно перемещаться по файлам и репозиториям исходного кода из GitHub, а также вносить и фиксировать изменения кода. В редакторе можно открыть любой репозиторий, вилку или запрос на вытягивание.
Редактор github.dev доступен всем бесплатно в GitHub.com.
Редактор github.dev предоставляет множество преимуществ Visual Studio Code, таких как поиск, выделение синтаксиса и представление системы управления версиями. Также вы можете с помощью синхронизации параметров передать в редактор собственные настройки VS Code. Дополнительные сведения см. в разделе Синхронизация параметров документации по VS Code.
Редактор github.dev полностью работает в песочнице браузера. Для выполнения большинства функций, которые вы будете использовать, этот редактор не клонирует репозиторий, а применяет расширение репозиториев GitHub. Ваша работа сохраняется в локальном хранилище браузера, пока вы не выполните фиксацию. Вам нужно регулярно фиксировать изменения, чтобы они были доступны в репозитории.
Чтобы использовать редактор github.dev, необходимо войти в github.dev в GitHub.com.
Открытие редактора github.dev
Любой репозиторий GitHub в github.dev можно открыть любым из следующих способов:
-
Чтобы открыть репозиторий на той же вкладке браузера, нажмите клавишу . при просмотре любого репозитория или запроса на вытягивание в GitHub.
Чтобы открыть репозиторий на новой вкладке браузера, нажмите клавишу >.
-
В URL-адресе вместо "github.com" укажите "github.dev".
-
При просмотре файла откройте раскрывающееся меню рядом с и выберите действие Открыть в github.dev.
Codespaces и github.dev
github.dev и GitHub Codespaces позволяют редактировать код непосредственно из репозитория. Но они предоставляют немного разные преимущества, в зависимости от варианта использования.
| github.dev | GitHub Codespaces | |
|---|---|---|
| Стоимость | Свободная. | Бесплатная ежемесячная квота использования для личных учетных записей. Сведения о ценах см. в разделе Сведения о выставлении счетов за GitHub Codespaces. |
| Доступность | Доступно для всех пользователей на сайте GitHub.com. | Доступно для всех пользователей на сайте GitHub.com. |
| Запуск | github.dev открывается мгновенно при нажатии клавиши, и вы можете начать использовать его сразу, не дожидаясь дополнительной настройки или установки. | При создании или возобновлении пространства кода потребуются настройка виртуальной машины и контейнера на основе содержимого файла devcontainer.json. Для этого нужно настроить среду, что занимает несколько минут. Дополнительные сведения см. в разделе Создание codespace для репозитория. |
| Среда выполнения приложений | Вычислительные ресурсы не предоставляются, поэтому вы не сможете компилировать и запускать код или использовать интегрированный терминал. | С помощью GitHub Codespaces вы получаете возможности выделенной виртуальной машины, на которой можно запускать и отлаживать приложение. |
| Доступ к терминалу | Нет. | GitHub Codespaces предоставляет общий набор средств по умолчанию, что означает, что терминал можно использовать точно так же, как и в локальной среде. |
| Расширения | В представлении расширений появится только подмножество расширений, которые могут выполняться в формате веб-приложения. Дополнительные сведения см. в разделе Использование расширений. | С помощью GitHub Codespaces можно использовать большинство расширений из Visual Studio Code Marketplace. |
Продолжить работу с Codespaces
Вы можете запустить рабочий процесс в github.dev и продолжить работу с codespace. Если вы попытаетесь получить доступ к представлению запуска и отладки или терминалу, вы получите уведомление о том, что они недоступны в github.dev.
Чтобы продолжить работу в пространстве кода, последовательно щелкните Продолжить работу на... и Создать новое пространство кода, чтобы создать пространство кода для текущей ветви. Перед выполнением этого действия необходимо зафиксировать любые изменения.
Использование системы управления версиями
При использовании github.dev все действия управляются с помощью представления системы управления версиями, которое находится на панели действий слева. Дополнительные сведения о представлении системы управления версиями см. в разделе Управление версиями документации по VS Code.
Так как github.dev использует расширение GitHub Repositories для обеспечения своей функциональности, вы можете переключать ветви без необходимости прятать изменения. Дополнительные сведения см. в разделе Репозитории GitHub документации по VS Code.
Создание ветви
- Если текущая ветвь не отображается в строке состояния, в нижней части кодового пространства щелкните строку состояния правой кнопкой мыши и выберите Управление версиями.
- Выберите имя ветви в строке состояния.
- В раскрывающемся списке щелкните ветвь, на которую хотите переключиться, или введите имя новой ветви и нажмите Создать новую ветвь.
Все незафиксированные изменения, внесенные в старой ветви, будут доступны и в новой ветви.
Фиксация изменений
- На панели действий щелкните представление Система управления версиями.
- Чтобы подготовить изменения, щелкните знак + рядом с измененным файлом или рядом с элементом Изменения, если вы изменили несколько файлов и хотите подготовить их все.
- Введите сообщение о фиксации, описывающее внесенное изменение.
- Чтобы зафиксировать промежуточные изменения, установите флажок в верхней части боковой панели системы управления версиями.
- При фиксации изменений они автоматически передаются в выбранную ветвь в GitHub.
Создание запроса на включение изменений
- После фиксации изменений в локальной копии репозитория щелкните значок Создать запрос на вытягивание.
- Убедитесь в том, что локальная ветвь и репозиторий, из которых выполняется слияние, а также удаленная ветвь и репозиторий, с которыми выполняется слияние, выбраны правильно. Затем задайте для запроса на вытягивание название и описание.
- Нажмите кнопку Create (Создать).
Работа с существующим запросом на вытягивание
Для работы с существующим запросом на вытягивание можно использовать github.dev.
- Перейдите к запросу на вытягивание, который вы хотите открыть в github.dev.
- Нажмите,
.чтобы открыть запрос на вытягивание в github.dev. - Внесите нужные изменения и зафиксируйте их, выполнив действия, описанные в разделе Фиксация изменений. Все изменения будут сразу зафиксированы в выбранной ветви, их не нужно дополнительно отправлять.
Применение расширений
Редактор github.dev поддерживает расширения VS Code, которые были специально созданы или обновлены для запуска в Интернете. Такие расширения называются "веб-расширениями". Сведения о том, как создать веб-расширение или дополнить существующее расширение поддержкой этого формата, см. в разделе Веб-расширения документации по VS Code.
Расширения, которые могут выполняться в github.dev, будут отображаться в представлении расширений и могут быть установлены. При использовании синхронизации параметров автоматически устанавливаются и все совместимые расширения. Подробнее см. раздел Синхронизация параметров документации по VS Code.
Использование github.dev за брандмауэром
Если вы работаете за брандмауэром, необходимо добавить следующие URL-адреса в список разрешений брандмауэра:
| URL-адрес | Использование |
|---|---|
https://*.vscode-cdn.net | github.dev полностью выполняется в браузере. Для этого необходимо скачать ресурсы VS Code из конечных точек по этому URL-адресу. |
https://update.code.visualstudio.com | Как описано выше. |
https://api.github.com | Используется для получения исходных файлов из GitHub |
https://vscode-sync-insiders.trafficmanager.net | Дополнительные. Чтобы разрешить синхронизацию параметров с помощью синхронизации параметров. |
Каждое расширение, установленное в github.dev, выполняется в независимой веб-рабочей роли. Это добавляет уровень безопасности между несколькими расширениями, работающими в одном браузере. В результате URL-адреса запросов, поступающие от расширений, похожи на следующие: https://v--151hfiju3s93ktt2rqh65902gukb27osot905m4g52k40kaea3h6.vscode-cdn.net.
Данные извлекаются из репозитория во время выполнения с помощью расширения GitHub Repositories . Эти данные не хранятся на локальном компьютере между сеансами github.dev, за исключением хранилища несохраненных и текущих файлов в браузере (для перезагрузки страниц). Единственные данные, не относящиеся к репозиторию, которые хранятся локально между сеансами, — это некоторые параметры пользователя и учетные данные, отправленные потоком проверки подлинности GitHub.
Устранение неполадок
Если у вас возникли проблемы с открытием github.dev, попробуйте выполнить следующие действия:
- Убедитесь, что вы выполнили вход в GitHub.
- Отключите все блокировщики рекламы.
- Используйте окно без инкогнито в браузере, чтобы открыть github.dev.
Известные ограничения
- Редактор github.dev в настоящее время поддерживается в Chrome (и других браузерах на основе Chromium), Edge, Firefox и Safari. Мы рекомендуем всегда использовать последнюю версию любого из этих браузеров.
- Некоторые настраиваемые сочетания клавиш могут работать не во всех браузерах. Существующие ограничения для настраиваемых сочетаний клавиш описаны в разделе Известные ограничения и адаптации документации по VS Code.
.может не работать для открытия github.dev в соответствии с локальной раскладкой клавиатуры. В этом случае можно открыть любой репозиторий GitHub в github.dev, изменив URL-адрес сgithub.comнаgithub.dev.