Registrar seu aplicativo

Os sistemas operacionais têm procedimentos de registro ligeiramente diferentes, mas conceitualmente são todos os mesmos. Os aplicativos que são distribuídos para serem utilizados por outros devem ser registrados. Mesmo que o ArcGIS AppStudio realize o registro do aplicativo e processo de construção para você, você ainda deverá obter os arquivos de registro de cada vendedor do sistema operacional para fornecer como entradas do AppStudio.

Preparar um novo aplicativo

Antes de você registrar e liberar seu aplicativo, ele deve receber um ID de Cliente do ArcGIS, um URI para redirecionar e uma string de licença. Embora um aplicativo ainda possa ser criado sem um ID de Cliente ou um URI de redirecionamento, ambos são importantes em um aplicativo que usa serviços ArcGIS.

Um ID de Cliente do ArcGIS—também denominado AppID—é necessário para registro de usuário nomeado para todos os aplicativos. Para obter um ID de Cliente, vá até https://developers.arcgis.com, registre com suas credenciais de desenvolvedor, clique na seta suspensa próxima ao Painel, e escolha Novo Aplicativo. Depois de registrado, você receberá um ID de cliente, que pode ser copiado em seu aplicativo do AppStudio. Se você estiver utilizando ArcGIS AppStudio, um ID de cliente também pode ser gerado em Configurações > Licenciamento clicando no botão Registrar.

Se o seu aplicativo exigir registro de usuário nomeado, você também precisará fornecer um URI para redirecionar. URIs para redirecionar representam locais válidos que um usuário pode ser redirecionado após completar um registro de OAuth. Para adicionar uma nova URI de redirecionamento para seu aplicativo, vá até a guia Autenticação para seu aplicativo em https://developers.arcgis.com. Aqui, registre seu aplicativo, se ainda não o fez, e adicione seu próprio URI de redirecionamento ou adicione urn:ietf:wg:oauth:2.0:oob para usar a página de redirecionamento hospedada de volta ao seu aplicativo no ArcGIS Online. O URI urn:ietf:wg:oauth:2.0:oob também é definido automaticamente para quaisquer aplicativos feitos e registrados no ArcGIS AppStudio.

Uma string de licença é exigida para construir aplicativos que utilizam a versão ArcGIS Runtime 100.x. Um aplicativo não pode ser construído sem uma string de licença, que também denota as funções da plataforma ArcGIS que o aplicativo é autorizado para executar. Para informações sobre como obter uma string de licença, consulte Licenciar seu aplicativo.

Entre no seu aplicativo iOS

Todos os aplicativos iOS precisam ser registrados. Os aplicativos criados para testes devem ser registrados por um certificado de desenvolvedor que está vinculado à sua conta de desenvolvedor da Apple e o dispositivo no qual você realiza o teste. Um certificado de produção está vinculado somente à sua conta de desenvolvedor da Apple.

Antes de executar a ferramenta Make localizada no painel lateral da galeria do AppStudio, na nuvem ou local, tenha certeza que você forneceu o seguinte na guia iOS das Configurações, localizadas no cabeçalho Plataformas:

• ID do Pacote—Sempre utilize um nome de domínio reverso da internet, por exemplo, com.companyname.applicationname. O nome do pacote é um identificador único para o aplicativo e é o nome padrão para o processo do aplicativo. Após você publicar seu aplicativo você não poderá alterar o nome do pacote. Para detalhes adicionais, consulte a explanação de ID do pacote em Preparar para distribuição do aplicativo.
• Perfil de aprovisionamento—Indica os dispositivos onde você planeja executar seu aplicativo.
• Certificado (arquivo .p12)—Certificado para App Store ou distribuição interna. Este arquivo é criado em Keychain Access. Se você não fornecer estas informações e o ID do pacote no AppStudio, os arquivos de instalação não serão gerados. Para mais informações, consulte O que é registro do aplicativo?

No momento de executar a ferramenta Make, você será solicitado para fornecer a senha do certificado.

Para criar o arquivo de certificado exigido para registro, as seguintes etapas precisam ser executadas uma vez pelo desenvolvedor e exigem um Mac:

1. Baixe seu certificado de desenvolvedor (por exemplo, ios_developer.cer) a partir do iOS Dev Center.
2. Baixe seu perfil de aprovisionamento móvel (por exemplo, ios_developer.mobileprovision) do iOS Dev Center.
3. Utilize o Localizador para procurar por Aplicativos > Utilitários > Keychain Access.
4. Importe seu certificado no Keychain Access.
5. Em Keychain Access, a partir da lista Keychain, escolha login, e a partir da lista Categoria, escolha Meus Certificados. Escolha o certificado de Desenvolvedor de Telefone Nomeado: Seu Nome e exporte o certificado com a chave privada com uma senha (por exemplo, john_doe_private_key.p12).

   Seu arquivo de certificado foi criado.

6. No AppStudio, procure por Configurações > Plataformas > iOS.
7. Defina o caminho do perfil de provisionamento.
8. Defina o tipo de distribuição para seu aplicativo. Para mais informações sobre as opções, consulte a documentação do Xcode sobre métodos de distribuição.

Anotação:

Clique duas vezes no arquivo de certificado .p12 e perfil de provisionamento móvel para importar os arquivos.

Se você estiver utilizando o AppStudio no macOS, duas propriedades adicionais deverão ser definidas para a criação de aplicativos iOS com Make local. O conteúdo destes campos pode ser encontrado no seu certificado de desenvolvimento ou distribuição, que pode ser visto utilizando o Localizador para navegar até Aplicativos > Utilities > Keychain Access.

Forneça a unidade organizacional do certificado no campo ID da Equipe .

Forneça o nome comum do certificado no campo Identidade de Registro do Código .

Entre no seu aplicativo Android

Para preparar a construção de uma versão do Android você deve primeiro gerar um arquivo keystore de registro. Para informações detalhadas sobre como criar este arquivo, consulte a Documentação do Android.

Antes de executar a ferramenta Make na nuvem ou local, tenha certeza que você forneceu o seguinte na guia Android das Configurações, localizadas no cabeçalho Plataformas:

• Nome do pacote—Sempre utilize um nome de domínio reverso da internet, por exemplo, com.companyname.applicationname. O nome do pacote é um identificador único para o aplicativo e é o nome padrão para o processo do aplicativo. Após você publicar seu aplicativo você não poderá alterar o nome do pacote. Para detalhes adicionais, visualize a explicação de nome do pacote em elemento de manifesto do Android SDK.
• Caminho do arquivo de keystore—O local do arquivo de keystore em sua máquina de desktop.
• Nome alternativo da chave—Nome da chave criado no momento da criação do keystore.

Se você não fornecer estas informações, seus arquivos de instalação ainda serão criados, mas eles não serão registrados. Os arquivos não registrados podem ser instalados para propósitos de teste, mas não podem ser enviados à loja Google Play ou Amazon Appstore.

No momento de executar a ferramenta Make, você será solicitado para fornecer as senhas do certificado e do keystore.

Para criar um keystore, as seguintes etapas precisam ser executadas uma vez por desenvolvedor:

1. Baixe e instale o Java Development Kit (JDK) do https://www.oracle.com/technetwork/java/javase/downloads/index.html.
2. Crie uma variável de ambiente denominada JAVA_HOME em sua máquina de desktop: https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/index.html.
3. Adicione o caminho da pasta bin do JDK para sua variável de ambiente PATH.
4. Em uma janela de comando, utilize o seguinte para criar a chave: keytool -genkey -v -keystore [keystore_name].keystore -alias [alias_name] -keyalg RSA -keysize 2048 -validity 10000, onde keystore_name é o nome que você escolheu para o arquivo keystore resultante e alias_name é o nome que você escolheu como um nome alternativo.
5. Insira uma senha de keystore e confirme.
6. Insira as informações adicionais e confirme.
7. Insira uma senha da chave. Esta senha pode ser única ou pressione Enter para utilizar a mesma senha que a senha do keystore.

   Seu arquivo de keystore será criado na pasta onde você executou este comando.

Entre no seu aplicativo macOS

Semelhante ao Android, se você não fornecer um certificado ao solicitar os arquivos de instalação do macOS, eles ainda serão criados, mas não registrados. Os arquivos não registrados podem ser instalados para propósitos de teste, mas não podem ser enviados ao Google Play Store. As seguintes etapas são semelhantes ao iOS; porém, um perfil de aprovisionamento não é exigido para macOS. Para mais informações, consulte O que é registro do aplicativo?

Antes de executar a ferramenta Make, na nuvem ou local, assegure que você forneceu o seguinte na guia macOS das Configurações, localizado no cabeçalho Plataformas:

• ID do Pacote—Sempre utilize um nome de domínio reverso da internet, por exemplo, com.companyname.applicationname. O nome do pacote é um identificador único para o aplicativo e é o nome padrão para o processo do aplicativo. Após você publicar seu aplicativo você não poderá alterar o nome do pacote. Para detalhes adicionais, consulte a explanação de ID do pacote em Preparar para distribuição do aplicativo.
• Certificado (arquivo .p12)—Certificado para App Store ou distribuição interna. Este arquivo é criado em Keychain Access. Se você não fornecer estas informações e o ID do pacote no AppStudio, os arquivos de instalação não serão gerados. Para mais informações, consulte O que é registro do aplicativo?

No momento de executar a ferramenta Make, você será solicitado para fornecer a senha do certificado.

Para criar o arquivo de certificado exigido para registrar um aplicativo macOS, siga as mesmas etapas conforme descritas acima para aplicativos iOS.

Entre no seu aplicativo Windows

Semelhante ao Android, se você não fornecer um certificado ao solicitar os arquivos de instalação do Windows, eles ainda serão criados, mas não registrados.

Antes de executar a ferramenta Make, cloud ou local, certifique-se de ter fornecido um arquivo de certificado na guia Windows de Configurações, localizado no cabeçalho Plataformas. Este certificado (arquivo .p12 ou .pfx) é para a Windows Store ou distribuição interna. Consulte Criar um certificado para registro de pacote na documentação de desenvolvedor da Microsoft para mais informações.