Skip to main content

Установка приложений GitHub

Если ваше приложение является общедоступным, любой пользователь может использовать URL-адрес установки для установки приложения в своем репозитории. Если ваше приложение является частным, его можно установить только в репозиториях, которыми вы владеете.

Примечание. Ваш GitHub App будет иметь доступ ко всем репозиториям, которые создает приложение, даже если кто-то установит ваше приложение только в выбранных репозиториях.

Установка частного приложения GitHub в репозитории

Создав частное приложение GitHub, вы можете установить его в один из своих организационных или пользовательских репозиториев. Дополнительные сведения см. в разделе Поток частной установки.

  1. На странице параметров приложений GitHub выберите свое приложение.
  2. На боковой панели слева щелкните Установка приложения.
  3. Щелкните Установить рядом с организацией или личной учетной записью, содержащей правильный репозиторий.
  4. Установите приложение во всех репозиториях или выберите репозитории. Разрешения на установку приложений
  5. После установки вы увидите параметры конфигурации для приложения в выбранной учетной записи. Здесь можно внести изменения или повторить предыдущие действия, чтобы установить приложение в другой учетной записи.

Разрешение пользователям устанавливать общедоступное приложение в своем репозитории

Можно разрешить другим пользователям устанавливать ваше общедоступное приложение, указав URL-адрес установки в таких местах, как домашняя страница вашего приложения. Затем можно указать домашнюю страницу своего приложения с целевой страницы на GitHub.

При переходе с приложения OAuth на приложение GitHub можно использовать параметры запроса для предварительного выбора репозиториев и учетной записи при установке приложения GitHub. Дополнительные сведения см. в разделе Миграция с приложений OAuth в приложения GitHub.

В этих инструкциях предполагается, что вы создали GitHub App:

  1. На странице параметров приложений GitHub выберите общедоступное приложение, которое необходимо настроить, чтобы другие пользователи могли его установить.
  2. В поле "URL-адрес домашней страницы" введите URL-адрес домашней страницы приложения и щелкните Сохранить изменения. URL-адрес домашней страницы
  3. GitHub предоставляет целевую страницу для приложения, которая содержит ссылку на "URL-адрес домашней страницы" приложения. Чтобы посетить целевую страницу на GitHub, скопируйте URL-адрес из "Общедоступной ссылки" и вставьте его в браузер. Общедоступная ссылка
  4. Создайте домашнюю страницу для приложения, включающую URL-адрес для установки приложения: http(s)://HOSTNAME/apps/<app name>/installations/new.

Авторизация пользователей во время установки

Процесс авторизации можно упростить, выполнив его во время установки приложения. Для этого выберите Запросить авторизацию пользователя (OAuth) во время установки при создании или изменении приложения в GitHub. Дополнительные сведения см. в разделе Создание приложения GitHub.

После установки приложения потребуется получить маркер доступа для пользователя. Дополнительные сведения см. в шагах 2 и 3 в разделе Идентификация пользователей на вашем сайте.

Сохранение состояния приложения во время установки

Можно указать параметр state в URL-адресе установки для приложения, чтобы сохранить состояние страницы приложения и вернуть людей в это состояние после установки, проверки подлинности или принятия обновлений для приложения GitHub. Например, можно использовать state для корреляции установки с пользователем или учетной записью.

Чтобы сохранить состояние, добавьте в URL-адрес установки:

http(s)://HOSTNAME/apps/<app name>/installations/new?state=AB12t