Empacotar seu aplicativo compilado com o Visual Studio Tools for Apache Cordova

  • Artigo

No Visual Studio 2013, as ferramentas do Cordova são lançadas como uma versão de visualização (CTP). As ferramentas do Cordova serão lançadas como parte do Visual Studio 2015 e recomendamos usar o Visual Studio 2015 RTM para desenvolver aplicativos usando o Visual Studio Tools for Apache Cordova. Você pode baixar o Visual Studio no Centro de Download da Microsoft.

Quando você empacota o aplicativo que você criou usando o Visual Studio Tools para o Apache Cordova, você desejará definir as configurações necessárias para publicar seu aplicativo. Além das configurações gerais, também há etapas necessárias específicas para a plataforma na maioria dos casos.

Neste artigo:

  • Definir configurações de compilação

  • Definir as configurações gerais de pacote de aplicativo

  • Empacotar e assinar um aplicativo Android

  • Empacotar e assinar um aplicativo iOS

  • Pacote e assinar um Windows 8, Windows 8.1 ou aplicativo do Windows Phone 8.1

  • Empacotar e assinar um aplicativo do Windows Phone 8

Para obter um tutorial que percorra o pacote e o processo de publicação, consultepacote e publicar seus aplicativos Cordova.

Definir configurações de compilação

Ao criar seu aplicativo, você precisa escolher a configuração de compilação correta. Você pode escolher configurações de compilação Debug ou Release.

  • Depure. Essa configuração de compilação é usada para depurar aplicativos. Para o Android, isso cria uma depuração APK (com nenhuma versão de assinatura). Para iOS, por padrão o Visual Studio agente remoto seleciona o primeiro iOS válido identidade de assinatura de desenvolvimento instalado em seu Mac.

  • Versão. Essa configuração de compilação deve ser usada para pacotes de versão. Para o Android, você precisa fornecer um armazenamento de chaves é usado para assinar a versão APK. Para iOS, por padrão o Visual Studio agente remoto seleciona o primeiro iOS válido identidade de assinatura de distribuição instalado em seu Mac.

Definir as configurações gerais de pacote de aplicativo

Você pode especificar detalhes como o número de ID e a versão do pacote usando o designer de configuração, que é a interface do Visual Studio para o arquivo config.xml. No Gerenciador de Soluções, abra o menu de atalho para o config.xml e escolha Abrir ou Ver designer (ou clique duas vezes no arquivo).

Important settings in the Config Deisgner

Você deve definir as seguintes configurações para empacotar seu aplicativo para distribuição.

  • Nome de exibição, que especifica o nome do aplicativo que aparece em uma loja de aplicativos.

    Dica

    A ID de pacote e o nome de exibição da Windows Store são especificados de forma diferente.Consulte opacote e assinar um Windows 8, Windows 8.1 e aplicativo do Windows Phone 8.1seção mais adiante neste artigo.

  • ID do pacote, que especifica uma cadeia de caracteres exclusiva que identifica seu aplicativo em cada plataforma (exceto Windows 8) ao publicar seu aplicativo para uma loja.

  • Versão, que especifica o número da versão do aplicativo. Algumas lojas de aplicativos podem ter controle de versão independente que é atribuído quando o aplicativo é publicado. No entanto, para plataformas como iOS, você deve manter esse número em sincronia com a versão configurada no iTunes Connect.

  • Acesso ao domínio, que especifica o conjunto de domínios de onde seu aplicativo pode acessar o conteúdo. Durante o desenvolvimento, é recomendável usar o valor padrão, "*", que fornece acesso a todo o conteúdo. No entanto, antes de lançar seu aplicativo, use essa configuração para restringir seu aplicativo a domínios específicos necessários para seu aplicativo. (O Windows 8 atualmente não usa essa definição de configuração.)

Para obter informações sobre as preferências que podem ser definidas manualmente no config.xml, consulte o arquivo config.xml na documentação do Apache Cordova.

Empacotar e assinar um aplicativo Android

Cada vez que você cria seu aplicativo para o Android, um pacote é criado. Etapas adicionais são necessárias para assinar seu aplicativo para distribuição.

Para assinar um aplicativo Android para distribuição

  1. Gere um armazenamento de chaves e forneça as informações necessárias para criar um certificado (chave privada). Para obter mais informações, consulte Assinando seus aplicativos na documentação do Android.

  2. Quando você tiver criado um armazenamento de chaves, abra a pasta res\native\android.

  3. Abra o arquivo ant.properties e digite as informações sobre o armazenamento de chaves e o alias.

    A propriedade Key.store no ant.properties deverá especificar um caminho relativo ou absoluto para o arquivo de certificado.

  4. Coloque o armazenamento de chaves que você criou na mesma pasta que o ant.properties ou em outro local. (Por exemplo, por motivos de segurança, não convém marcar o armazenamento de chaves no controle de origem.)

  5. Crie o aplicativo Android.

    Quando você cria o aplicativo, o Visual Studio assinará o pacote com as credenciais fornecidas.

    Aviso

    O Visual Studio não validar as credenciais, portanto, certifique-se de que estejam corretas.

Se você excluir acidentalmente o arquivo ant.properties, crie um novo projeto e copie o arquivo do seu novo projeto para o projeto anterior.

Dica

Para obter informações sobre como criar os ativos de empacotamento para o Android, consulte ogithub documentação.

Empacotar e assinar um aplicativo iOS

Para gerar um pacote que pode ser usado em um dispositivo iOS, você precisará assiná-lo usando um conta de Desenvolvedor de iOS da Apple válida e um Mac com Xcode.

Para assinar um aplicativo iOS

  1. Crie um perfil de provisionamento para seu aplicativo por meio do portal do desenvolvedor da Apple.

  2. Baixe e instale o perfil de provisionamento no Mac que você está usando como computador de compilação.

  3. No Xcode, abra ocontaspainel Preferências e verifique se sua ID da Apple está registrado. Se não estiver listado, escolha o**+**botão para adicioná-lo.

  4. No Visual Studio, escolha uma configuração de depuração ou versão.

    • Ao criar uma configuração de depuração, por padrão o Visual Studio agente remoto seleciona o primeiro iOS válido identidade de assinatura de desenvolvimento instalado em seu Mac.

    • Ao criar uma configuração de versão, por padrão o Visual Studio agente remoto seleciona o primeiro iOS válido identidade de assinatura de distribuição instalado em seu Mac.

    Importante

    Certifique-se de que o seu Mac tem o perfil de provisionamento apropriado que corresponda à configuração que você escolher.Para obter informações detalhadas, leia no iOS biblioteca do desenvolvedor.Manter as identidades e certificados de assinatura

    Dica

    Uma identidade de assinatura é válida se o identificador do perfil de provisionamento corresponde ao ID de pacote especificado no designer de configuração do Visual Studio.Por exemplo, um perfil de provisionamento de com.msft.multidevice.* corresponde à ID de pacote de com.msft.multidevice.someName.Em muitos casos, você poderá usar um provisionamento perfil curinga que corresponde a todos os IDs de pacotes, quando a validade não for uma preocupação.

  5. Crie seu aplicativo.

Dica

Para obter informações sobre como criar os ativos de empacotamento para iOS, consulte ogithub documentação.

Para forçar uma identidade de assinatura específica

  1. Crie uma pasta res\native\ios\cordova em seu projeto Cordova.

  2. Para substituir a identidade de assinatura ou provisionamento de perfil para a configuração de depuração, colocar um arquivo de debug.xcconfig de compilação personalizada nessa pasta ou colocar um arquivo de compilação release.xcconfig para substituir a configuração de versão.

    • Os arquivos de base podem ser encontradosaquino github.

    • compilação release.xcconfig tem um exemplo da sintaxe para definir uma identidade de assinatura.

    • Ao criar seu próprio arquivo xcconfig, certifique-se de incluir o seguinte na parte superior do file:#include "build.xcconfig"

    • Para um conjunto completo de configurações de compilação que pode ser substituído, consulteas configurações de compilação do Xcode.

Empacote e assine um Windows 8, Windows 8.1., ou o aplicativo Windows Phone 8.1

Visual Studio fornece recursos internos para aplicativos do Windows 8, Windows 8.1 e Windows Phone 8.1 pacote para distribuição. Esses pacotes são APPX pacotes.

Aviso

O AppxManifest não pode ser atualizada corretamente quando você cria uma associação de armazenamento.Isso pode resultar em um erro ao publicar um aplicativo para o armazenamento.Além disso, o Designer de configuração não oferece um método para criar pacotes APPX atualmente.Consulteproblemas conhecidospara obter soluções para problemas comuns.

Para assinar um aplicativo do Windows 8, Windows 8.1 ou Windows Phone 8.1 para distribuição

  1. No Visual Studio, escolha Projeto, Loja, Associar o aplicativo à loja.

    Associate an app with the Windows Store

  2. Quando solicitado, entrar com sua conta da Microsoft, escolha um nome para seu aplicativo e escolha Reservar.

    Aviso

    Nomes de aplicativo devem ser exclusivos na Windows Store.

  3. Depois que o aplicativo for reservado, escolha Associar.

    O Visual Studio atualiza o pacote do aplicativo. Para ver onde o nome reservado é usado, abra o designer de configuração e veja o nome de exibição e a ID do pacote na guia Empacotamento.

Dica

Para obter informações sobre como criar os ativos de empacotamento do Windows, consulte ogithub documentação.

Empacotar e assinar um aplicativo do Windows Phone 8

Aplicativos do Windows Phone 8 são empacotados automaticamente e não precisam ser assinado no tempo de compilação. Você pode enviar o arquivo XAP gerado para a loja conforme descrito em Enviar seu aplicativo no Centro de Desenvolvimento do Windows.

Dica

Se você configurar o Windows Phone 8.1 como o destino de compilação, o pacote gerado é um APPX.Para obter mais informações, consulte a seção anterior.

Se você precisar alterar o idioma padrão em um pacote do Windows Phone 8, localize o arquivo WMAppManifest. XML na compilação/depuração/plataformas/wp8, modifique a < código DefaultLanguage = "en-US" xmlns = "" / > marca e incluir o arquivo no seu projeto do Visual Studio na seguinte pasta: /res/native/wp8/Properties. Dessa forma, você pode incluir o arquivo XML personalizado em seu projeto gerado.

Download the tools Obter o Visual Studio Tools para o Apache Cordovaoumais

Consulte também

Conceitos

Publicar seu aplicativo compilado com o Visual Studio Tools for Apache Cordova

Outros recursos

FAQ