Compartilhando seu Aplicativo GitHub

Compartilhar o GitHub App no GitHub Marketplace

Se o GitHub App for público, você poderá optar por publicá-lo no GitHub Marketplace. Para saber mais, confira Sobre GitHub Marketplace para aplicativos.

Se você for um Enterprise Managed User, não poderá compartilhar o aplicativo no GitHub Marketplace.

Para mais informações sobre como os usuários podem instalar seu aplicativo por meio do GitHub Marketplace, confira Instalando um Aplicativo GitHub por meio do GitHub Marketplace em suas organizações e Instalando um Aplicativo GitHub por meio do GitHub Marketplace em sua conta pessoal.

Compartilhando o GitHub App por meio de um link de instalação

Se o GitHub App for público, outros usuários e organizações poderão instalar seu aplicativo. Para obter mais informações sobre como tornar o aplicativo público, confira Tornando um aplicativo GitHub público ou privado.

Se você for um Enterprise Managed User ou seu aplicativo pertencer à sua conta empresarial, você só poderá compartilhar seu aplicativo com contas em sua empresa.

1. No canto superior direito de qualquer página do GitHub, clique na foto do seu perfil.

2. Acesse as configurações da sua conta.

   • Para um aplicativo de propriedade de uma conta pessoal, clique em Configurações.
   • Para um aplicativo de propriedade de uma organização:
     1. Clique em Suas organizações.
     2. À direita da organização, clique em Configurações.
   • Para um aplicativo de propriedade de uma empresa:
     1. Se você usar Enterprise Managed Users, clique em Sua empresa para ir diretamente para as configurações da conta corporativa.
     2. Se você usar contas pessoais, clique em Suas empresas e, à direita da empresa, clique em Configurações.

3. Navegue até as configurações GitHub App.

   • Para um aplicativo pertencente a uma conta pessoal ou a uma organização:
     1. Na barra lateral esquerda, clique em Developer settings e clique em GitHub Apps.
   • Para um aplicativo de propriedade de uma empresa:
     1. Na barra lateral esquerda, em "Configurações", clique em GitHub Apps.

4. Ao lado do GitHub App que você deseja compartilhar, clique em Editar.

5. Clique em Página pública. O GitHub levará você para a página pública do GitHub App.

6. Clique em Instalar. O GitHub levará você para a URL de instalação do GitHub App. A URL será semelhante a https://github.com/apps/APP-NAME/installations/new, em que APP-NAME é o nome do GitHub App.

7. Compartilhe a URL de instalação com outros usuários. Para obter mais informações sobre como os usuários podem instalar o aplicativo por meio dessa URL, confira Instalando um Aplicativo GitHub de terceiros.

   Ao compartilhar a URL, você poderá incluir um parâmetro de consulta state na URL de instalação para preservar o estado da página do aplicativo e retornar as pessoas a esse estado depois que elas instalarem, autenticarem ou aceitarem as atualizações no GitHub App. Por exemplo, você pode usar o state para correlacionar uma instalação a um usuário ou a uma conta.

   Para preservar um estado, adicione-o à URL de instalação: https://github.com/apps/<app name>/installations/new?state=AB12t

Compartilhando seu GitHub App com instâncias do GitHub Enterprise Server

Se você quiser compartilhar seu GitHub App com instâncias do GitHub Enterprise Server da qual você não faz parte, execute as etapas adicionais. Para saber mais, confira Disponibilizando seu aplicativo GitHub para GitHub Enterprise Server.