Skip to main content
ドキュメントへの更新が頻繁に発行されており、このページの翻訳はまだ行われている場合があります。 最新の情報については、「英語のドキュメント」を参照してください。
All products
アプリ

GitHub Appのインストール

この記事の内容

アプリがパブリックの場合、誰でも GitHub Marketplace またはインストール URL を使用して、リポジトリにアプリをインストールできます。 アプリケーションがプライベートの場合は、あなたが所有するリポジトリにそのアプリケーションをインストールできるのはあなただけです。

注: GitHub Appは、誰かがアプリケーションを選択したリポジトリにだけインストールした場合でも、アプリケーションが作成するすべてのリポジトリにアクセスできます。

プライベートなGitHub Appのリポジトリへのインストール

プライベートなGitHub Appを作成した場合、自分のOrganizationあるいはユーザリポジトリにそれをインストールできます。 詳しくは、「GitHub Appをパブリックまたはプライベートにする」を参照してください。

  1. [GitHub アプリの設定] ページで、アプリを選択します。
  2. 左側のサイドバーで、 [アプリのインストール] をクリックします。
  3. 適切なリポジトリを含む組織または個人アカウントの横にある [インストール] をクリックします。
  4. [All repositories] (すべてのリポジトリ) または [Only select repositories] (選択したリポジトリのみ) を選択します。
  5. [Only select repositories] (選択したリポジトリのみ) を選択した場合は、 [Select repositories] (リポジトリの選択) ドロップダウン メニューを選択し、アプリをインストールするリポジトリをクリックします。
  6. [インストール] をクリックします。 インストールが終わると、選択したアカウントでアプリケーションの設定オプションが表示されます。 ここで変更をすることも、あるいは先のステップを繰り返して他のアカウントへアプリケーションをインストールすることもできます。

GitHub Marketplaceでのアプリケーションの提供

GitHub Marketplace では有料あるいは無料バージョンのアプリケーションを提供でき、ユーザがアプリケーションについて検索したり表示したりできます。 GitHub Marketplaceは注文が完了すると、自動的にGitHub Appをインストールします。

GitHub Marketplace にアプリを掲載する方法について詳しくは、「GitHub Marketplaceについて」を参照してください。

ユーザーが GitHub Marketplace からどのようにアプリをインストールできるかについて詳しくは、「GitHub Apps の使用」を参照してください。

ユーザがパブリックなアプリケーションをリポジトリにインストールできるようにする

アプリケーションのホームページのような場所にインストールURLを提供して、パブリックなアプリケーションをユーザがインストールできるようにすることができます。 そして、GitHub上のランディングページからアプリケーションのホームページを指すようにできます。

OAuth AppからGitHub Appに移行しているなら、GitHub Appをインストールする際にリポジトリとアカウントを事前選択するよう、クエリパラメータを利用できます。 詳しくは、「OAuth AppからGitHub Appへの移行」を参照してください。

以下のステップでは、GitHub App が作成されていることを前提としています。

  1. [GitHub アプリの設定] ページで、他のユーザーがインストールできるように構成するパブリックなアプリを選択します。
  2. [ホームページの URL] にアプリケーションのホームページの URL を入力し、 [変更を保存] をクリックしてください。 ホームページ URL
  3. GitHubは、アプリケーションの「ホームページURL」へのリンクを含むアプリケーションのためのランディングページを提供します。 GitHub上のランディングページにアクセスするには、「Public link（公開リンク）」からURLをコピーし、ブラウザに貼り付けてください。 パブリック リンク
  4. アプリのインストール URL を含むアプリのホーム ページを作成しますhttps://github.com/apps/<app name>/installations/new。

インストール中のユーザの認可

認可のプロセスは、アプリケーションのインストール中に完了させることでシンプルにできます。 そのためには、GitHub 上でアプリケーションを作成もしくは変更する際に [インストール中にユーザの認可 (OAuth) をリクエスト] を選択してください。 詳しくは、「GitHub App を作成する」を参照してください。

誰かがアプリケーションをインストールしたら、そのユーザのアクセストークンを取得する必要があります。 詳しくは、「ユーザーに代わって GitHub アプリで認証する」の手順 2 と 3 を参照してください。

インストール中のアプリケーションの状態の保持

アプリケーションのインストール URL にstate パラメーターを提供して、アプリケーション ページの状態を保持し、インストールや認可、GitHub App の更新を受け付けた後にその状態に戻れるようにできます。 たとえば、state を使ってインストールをユーザーあるいはアカウントと関連付けることができます。

状態を保持するには、インストールURLに追加します。

https://github.com/apps/<app name>/installations/new?state=AB12t