Примечание: Редактор 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.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 | |
|---|---|---|
| Стоимость | Свободная. | Бесплатная ежемесячная квота на использование личных учетных записей. Сведения о ценах см. в разделе About billing for GitHub Codespaces. |
| Доступность | Доступно для всех пользователей на сайте GitHub.com. | Доступно для всех пользователей на сайте GitHub.com. |
| Запуск | github.dev мгновенно открывается нажатием клавиши, и вы можете сразу же начать использовать его, не дожидаясь дополнительной настройки или установки. | При создании или возобновлении пространства кода потребуются настройка виртуальной машины и контейнера на основе содержимого файла devcontainer.json. Для этого нужно настроить среду, что занимает несколько минут. Дополнительные сведения см. в разделе Creating a codespace for a repository. |
| Среда выполнения приложений | Вычислительные ресурсы не предоставляются, поэтому вы не сможете компилировать и запускать код или использовать интегрированный терминал. | С помощью 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 . Эти данные не хранятся на локальном компьютере между сеансами 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.