Aplicativos para Windows 8.1 da Windows Store: assegure que os recursos sejam instalados em um dispositivo independentemente de serem necessários no dispositivo ou não

  • Artigo

 

Applies to Windows and Windows Phone

Ao incluir uma variedade de recursos em um pacote do aplicativo, você pode garantir que todos eles sejam instalados com seu aplicativo em cada dispositivo, independentemente dos recursos exigidos quando o aplicativo é instalado. Por exemplo, você pode garantir que as cadeias de caracteres da interface do usuário em vários idiomas sejam instaladas com seu aplicativo, não apenas o idioma correspondente à preferência de idioma do usuário do dispositivo. Se você usar essa estratégia, os usuários poderão alterar as preferências de idioma ou outras configurações sem estar conectados à Internet, e seus dispositivos poderão alternar para os melhores recursos para as novas configurações.

Incluir recursos em um pacote do aplicativo aumenta o tamanho do aplicativo. Se você deseja reduzir o tamanho do aplicativo, inclua recursos em pacotes de recursos que os usuários poderão baixar mais tarde. Para a maioria dos aplicativos, os pacotes de recursos proporcionam aos usuários a melhor experiência com a menor ocupação de espaço, mas os pacotes de recursos podem não ser apropriados para alguns aplicativos, como dicionários multilíngues, ferramentas de tradução ou outros aplicativos cujo idioma muda rapidamente. Esses aplicativos podem incluir uma variedade de recursos em um pacote do aplicativo.

Você pode incluir recursos em um pacote do aplicativo adicionando um arquivo de configuração. Como alternativa, se você se sentir confortável para editar o arquivo de projeto diretamente, poderá realizar essa tarefa fazendo isso também.

Opção 1: Adicionar um arquivo de configuração à sua solução

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto de seu aplicativo, aponte para Adicionar e clique em Novo Item.

  2. Na caixa de diálogo Adicionar Novo Item, clique no modelo Arquivo XML, nomeie o arquivo priconfig.packaging.xml e clique em Adicionar.

  3. Substitua o conteúdo do arquivo pelo XML a seguir.

    <packaging>
    <autoResourcePackage qualifier="Language" />
    <autoResourcePackage qualifier="Scale" />
    <autoResourcePackage qualifier="DXFeatureLevel" />
</packaging>

  4. Remova a linha do XML que representa a categoria de recursos que você não deseja incluir em um pacote de recursos. O exemplo a seguir mostra o conteúdo do arquivo priconfig.packaging.xml após o qualificador Language ser removido.

    <packaging>
    <autoResourcePackage qualifier="Scale" />
    <autoResourcePackage qualifier="DXFeatureLevel" />
</packaging>

    Nesse exemplo, todos os recursos de idioma serão incluídos em seu pacote de aplicativos, e os usuários os baixarão independentemente da preferência de idioma do usuário do dispositivo.

  5. Salve e feche o arquivo priconfig.packaging.xml.

  6. Se você remover o qualificador Language, adicione outro arquivo XML ao seu projeto chamado priconfig.default.xml e substitua o conteúdo do arquivo pelo XML a seguir.

    <default>
  <qualifier name="Language" value=Value />
</default>

    Dica

    Você não precisará adicionar um arquivo priconfig.default.xml ao seu projeto se remover o qualificador Scale ou DXFeatureLevel e não remover o qualificador Language.

    Substitua o espaço reservado Valor pelo código do idioma de cada recurso de idioma que você quer incluir em um pacote do aplicativo. O exemplo a seguir mostra como o XML poderá aparecer depois de substituir o espaço reservado Valor do qualificador de idioma por uma lista de códigos de idiomas.

    <default>
  <qualifier name="Language" value=”en;ja;de” />
  </default>

  7. No Gerenciador de Soluções, clique no arquivo priconfig.packaging.xml.

  8. Na janela Propriedades, altere os valores das propriedades a seguir de acordo com o idioma do projeto.

    • Para projetos C# e VB, defina a propriedade Ação de Compilação para Nenhuma.

    • Para projetos JavaScript, defina a propriedade Ação de Pacote como Nenhuma.

    • Para projetos C++, defina a propriedade Conteúdo como False.

  9. Se você tiver adicionado um arquivo priconfig.default.xml ao seu projeto, defina a propriedade Ação de Compilar desse arquivo para Nenhuma, a propriedade Ação de Empacotar para Nenhuma ou a propriedade Conteúdo para Falso, dependendo do idioma de seu projeto.

  10. No menu Criar, clique em Compilar Solução e crie o pacote do aplicativo.

    Na página Selecionar e Configurar Pacotes do assistente Criar Pacotes de Aplicativos, opte por gerar um pacote do aplicativo para o seu pacote. Consulte Criar um pacote do aplicativo do Windows 8.1.

  11. Na pasta ProjectFolder**\obj\**ReleaseConfiguration, abra o arquivo split.priconfig.xml no Bloco de Notas.

  12. Verifique se os qualificadores que você removeu não aparecem na lista de qualificadores de recursos.

Renomeando o arquivo priconfig.packaging.xml

Você pode atribuir qualquer nome ao arquivo de configuração. Mas, se você o nomear de forma diferente de priconfig.packaging.xml, deverá adicionar uma propriedade de compilação ao arquivo de projeto.

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto do seu aplicativo e clique em Descarregar Projeto.

  2. Clique com o botão direito no projeto novamente e, em seguida, clique em EditarAppName**.csproj** ou EditarAppName**.vbproj**.

  3. No arquivo de projeto, adicione a linha a seguir do XML entre as marcas de abertura e fechamento do primeiro elemento <PropertyGroup>.

    <AppxPriConfigXmlPackagingSnippetPath>FilePath</AppxPriConfigXmlPackagingSnippetPath>

    Importante

    Substitua FilePath pelo caminho do arquivo de configuração, incluindo o nome do arquivo.

  4. Salve e feche o arquivo de projeto.

  5. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e clique em Recarregar Projeto.

  6. Compile a solução e crie o pacote.

Dica

Se você tiver adicionado um arquivo priconfig.default.xml ao seu projeto, também poderá renomear esse arquivo. Para obter informações sobre como renomear esse arquivo, consulte Renomeando o arquivo priconfig.default.xml.

Opção 2: Modificar o arquivo de projeto (avançado)

  1. Abra o arquivo de projeto de seu aplicativo no Bloco de Notas.

  2. No arquivo de projeto, adicione a linha a seguir do XML entre as marcas de abertura e fechamento do primeiro elemento <PropertyGroup>.

    <AppxBundleAutoResourcePackageQualifiers>Language|Scale|DXFeatureLevel</AppxBundleAutoResourcePackageQualifiers>

  3. Nessa linha do XML, remova a categoria de recursos que você não deseja incluir em um pacote de recursos. O exemplo a seguir mostra a linha do XML após o qualificador Language ser removido.

    <AppxBundleAutoResourcePackageQualifiers>Scale|DXFeatureLevel</AppxBundleAutoResourcePackageQualifiers>

    Nesse exemplo, todos os recursos de idioma serão incluídos em seu pacote de aplicativos, e os usuários os baixarão independentemente da preferência de idioma do usuário do dispositivo.

  4. Se você remover o qualificador Language, adicione a linha a seguir do XML entre as marcas de abertura e fechamento do primeiro elemento <PropertyGroup>.

    <AppxDefaultResourceQualifiers>Language=Value</AppxDefaultResourceQualifiers>

    Dica

    Você não precisará adicionar essa linha se remover o qualificador Scale ou DXFeatureLevel e não remover o qualificador Language.

    Substitua o espaço reservado Valor pelo código do idioma de cada recurso de idioma que você quer incluir em um pacote do aplicativo. O exemplo a seguir mostra como o XML poderá aparecer depois de substituir o espaço reservado Valor do qualificador de idioma por uma lista de códigos de idiomas.

    <AppxDefaultResourceQualifiers>Language=en;ja;de</AppxDefaultResourceQualifiers>

  5. Salve e feche o arquivo de projeto. Em seguida, recarregue o arquivo no Visual Studio.

  6. Compile a solução e então crie o pacote do aplicativo.

    Na página Selecionar e Configurar Pacotes do assistente Criar Pacotes de Aplicativos, opte por gerar um pacote do aplicativo para o seu pacote. Consulte Criar um pacote do aplicativo do Windows 8.1.

  7. Na pasta ProjectFolder**\obj\**ReleaseConfiguration, abra o arquivo split.priconfig.xml no Bloco de Notas.

  8. Verifique se os qualificadores que você removeu não aparecem na lista de qualificadores de recursos.

Consulte também

Implantação de pacote de aplicativos
Pacotes de aplicativos
Como decidir se é para gerar um pacote de aplicativos
Pacotes de recursos
Sistema de gerenciamento de recursos
Definindo recursos de aplicativo (aplicativos usando C#/VB/C++ e XAML
Definindo recursos de aplicativo (aplicativos usando JavaScript e HTML)