Compartilhando seu Aplicativo GitHub

Compartilhando seu GitHub App em GitHub Marketplace

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

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

Para obter mais informações sobre como os usuários podem instalar seu aplicativo a partir de GitHub Marketplace, consulte 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 seu GitHub App por meio de um link de instalação

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

Se você tiver um Enterprise Managed User ou se o seu aplicativo pertencer à sua conta empresarial, você só poderá compartilhar seu aplicativo com contas dentro da 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. GitHub levará você para a página pública do seu GitHub App.

6. Clique em Instalar. GitHub levará você à URL de instalação da sua GitHub App. A URL será semelhante a https://github.com/apps/APP-NAME/installations/new, onde 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ê pode incluir um parâmetro de consulta state na URL de instalação para preservar o estado da página do aplicativo e levar as pessoas de volta a esse estado depois que instalarem, se autenticarem ou aceitarem atualizações no seu 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 GitHub Enterprise Server

Se você quiser compartilhar seu GitHub App com instâncias de GitHub Enterprise Server das quais não faz parte, precisará seguir etapas adicionais. Para saber mais, confira Disponibilizando seu aplicativo GitHub para GitHub Enterprise Server.