Примечание. Ваш GitHub App будет иметь доступ ко всем репозиториям, которые создает приложение, даже если кто-то установит ваше приложение только в выбранных репозиториях.
Установка частного приложения GitHub в репозитории
Создав частное приложение GitHub, вы можете установить его в один из своих организационных или пользовательских репозиториев. Дополнительные сведения см. в разделе Преобразование приложения GitHub в общедоступное или частное.
- На странице параметров приложений GitHub выберите свое приложение.
- На боковой панели слева щелкните Установка приложения.
- Щелкните Установить рядом с организацией или личной учетной записью, содержащей правильный репозиторий.
- Выберите Все репозитории или Только выберите репозитории.
- Если вы выбрали параметр "Выбрать только репозитории", выберите раскрывающееся меню Выбор репозиториев и выберите репозитории, в которые требуется установить приложение.
- Нажмите кнопку Установить. После установки вы увидите параметры конфигурации для приложения в выбранной учетной записи. Здесь можно внести изменения или повторить предыдущие действия, чтобы установить приложение в другой учетной записи.
Предложение приложения в GitHub Marketplace
Вы можете предложить платную или бесплатную версию приложения в GitHub Marketplace, где пользователи могут искать и просматривать сведения о приложении. GitHub Marketplace автоматически устанавливает приложение GitHub по завершении заказа.
Дополнительные сведения о добавлении приложения в GitHub Marketplace см. в разделе Сведения о GitHub Marketplace.
Дополнительные сведения о том, как пользователи могут установить приложение из GitHub Marketplace, см. в разделе Использование приложений GitHub.
Разрешение пользователям устанавливать общедоступное приложение в своем репозитории
Можно разрешить другим пользователям устанавливать ваше общедоступное приложение, указав URL-адрес установки в таких местах, как домашняя страница вашего приложения. Затем можно указать домашнюю страницу своего приложения с целевой страницы на GitHub.
При переходе с приложения OAuth на приложение GitHub можно использовать параметры запроса для предварительного выбора репозиториев и учетной записи при установке приложения GitHub. Дополнительные сведения см. в разделе Переход с OAuth Apps на GitHub Apps.
В этих инструкциях предполагается, что вы создали GitHub App:
- На странице параметров приложений GitHub выберите общедоступное приложение, которое необходимо настроить, чтобы другие пользователи могли его установить.
- На вкладке "Общие" в разделе "URL-адрес домашней страницы" введите URL-адрес домашней страницы приложения и нажмите кнопку Сохранить изменения.
- GitHub предоставляет целевую страницу для приложения, которая содержит ссылку на "URL-адрес домашней страницы" приложения. Чтобы посетить целевую страницу на GitHub, скопируйте URL-адрес из "Общедоступной ссылки" и вставьте его в браузер.
- Создайте домашнюю страницу для приложения, включающую URL-адрес для установки приложения:
https://github.com/apps/<app name>/installations/new.
Авторизация пользователей во время установки
Процесс авторизации можно упростить, выполнив его во время установки приложения. Для этого выберите Запросить авторизацию пользователя (OAuth) во время установки при создании или изменении приложения в GitHub. Дополнительные сведения см. в разделе Создание приложения GitHub.
После установки приложения потребуется получить маркер доступа для пользователя. Дополнительные сведения см. в разделе Создание маркера доступа пользователя для приложения GitHub.
Сохранение состояния приложения во время установки
Можно указать параметр state в URL-адресе установки для приложения, чтобы сохранить состояние страницы приложения и вернуть людей в это состояние после установки, проверки подлинности или принятия обновлений для приложения GitHub. Например, можно использовать state для корреляции установки с пользователем или учетной записью.
Чтобы сохранить состояние, добавьте в URL-адрес установки:
https://github.com/apps/<app name>/installations/new?state=AB12t