Веб-редактор github.dev

Примечание: Редактор 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.

Чтобы продолжить работу в пространстве кода, последовательно щелкните Продолжить работу на... и Создать новое пространство кода, чтобы создать пространство кода для текущей ветви. Перед выполнением этого действия необходимо зафиксировать любые изменения.

Screenshot of the "Run and Debug" side bar with a message saying that this feature is not available, and a "Continue Working On" button.

Использование системы управления версиями

При использовании 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`	github.dev полностью выполняется в браузере. Для этого необходимо скачать ресурсы VS Code из конечных точек по этому URL-адресу.
`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.

В этой статье