Compartilhar via

Aplicativos para Windows 8.1 da Windows Store: especificar os recursos padrão que são instalados em um dispositivo

  • Artigo

 

Applies to Windows and Windows Phone

Quando um usuário instala um aplicativo, o sistema operacional do dispositivo tenta identificar e instalar no aplicativo vários recursos apropriados para o dispositivo no qual ele está sendo instalado, como cadeias de caracteres da interface do usuário e imagens específicas da resolução. Por exemplo, um aplicativo pode ter cadeias de caracteres em espanhol que podem ser instaladas em dispositivos definidos para uma localidade apropriada. No entanto, seu aplicativo talvez não tenha recursos apropriados para cada dispositivo e localidade dos usuários. Nesses casos, o sistema operacional do dispositivo do usuário, por padrão, instala recursos que são apropriados para seu computador de desenvolvimento, sua localidade e outras configurações. Se você desejar que recursos diferentes sejam instalados no dispositivo, poderá especificá-los 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 em Arquivo XML, dê ao arquivo o nome de priconfig.default.xml e clique em Adicionar.

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

    <default>
  <qualifier name="Language" value=Value />
  <qualifier name="Contrast" value=Value />
  <qualifier name="Scale" value=Value />
  <qualifier name="HomeRegion" value=Value />
  <qualifier name="TargetSize" value=Value />
  <qualifier name="LayoutDirection" value=Value />
  <qualifier name="DXFeatureLevel" value=Value />
  <qualifier name="Configuration" value=Value />
  <qualifier name="AlternateForm" value=Value />
</default>

    Na próxima etapa, você substituirá os espaços reservados Valor por qualificadores de recursos válidos. Consulte Como nomear recursos usando qualificadores (aplicativos que usam C#/VB/C++ e XAML) ou Como nomear recursos usando qualificadores (aplicativos que usam JavaScript e HTML).

  4. Substitua cada espaço reservado de Valor por um qualificador de recurso válido.

    O exemplo a seguir mostra como o XML poderá aparecer depois que você substituir os espaços reservados de Valor por qualificadores de recursos válidos.

    <default>
  <qualifier name="Language" value="en-us" />
  <qualifier name="Contrast" value="standard" />
  <qualifier name="Scale" value="120" />
  <qualifier name="HomeRegion" value="001" />
  <qualifier name="TargetSize" value="256" />
  <qualifier name="LayoutDirection" value="LTR" />
  <qualifier name="DXFeatureLevel" value="DX9" />
  <qualifier name="Configuration" value="" />
  <qualifier name="AlternateForm" value="" />
</default>

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

  6. No Gerenciador de Soluções, clique no arquivo priconfig.default.xml.

  7. 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.

  8. No menu Compilar, clique em Compilar Solução.

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

  10. Verifique se os qualificadores que você adicionou aparecem no arquivo.

Renomeando o arquivo priconfig.default.xml

Você pode atribuir qualquer nome ao arquivo de configuração. Mas, se você o nomear de forma diferente de priconfig.default.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>.

    <AppxPriConfigXmlDefaultSnippetPath>FilePath</AppxPriConfigXmlDefaultSnippetPath>

    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, clique em Recarregar Projeto e compile a solução.

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

  1. Abra o arquivo de projeto do 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>. Esse XML identifica os recursos que o sistema operacional do dispositivo instalará se o aplicativo não tiver recursos apropriados para um dispositivo, uma localidade ou outra configuração em particular.

    <AppxDefaultResourceQualifiers>Language=ValueContrast=Value|Scale=Value|HomeRegion=Value|TargetSize=Value|
     LayoutDirection=Value|DXFeatureLevel=Value|Configuration=Value|AlternateForm=Value</AppxDefaultResourceQualifiers>

    Na próxima etapa, você substituirá os espaços reservados Valor por qualificadores de recursos válidos. Por exemplo, você definirá o qualificador Language para o moniker {DefaultResourceLanguage}. Quando você criar o pacote de aplicativo, o Visual Studio substituirá esse moniker pelo valor da propriedade Idioma padrão, que pode ser definida na guia Aplicativo do designer de manifesto. Como alternativa, você pode também definir o qualificador de idioma para um valor específico de localidade, como en-us. Consulte Como nomear recursos usando qualificadores (aplicativos que usam C#/VB/C++ e XAML) ou Como nomear recursos usando qualificadores (aplicativos que usam JavaScript e HTML).

  3. Substitua cada espaço reservado de Valor por um qualificador de recurso válido.

    O exemplo a seguir mostra como o XML poderá aparecer depois que você substituir os espaços reservados de Valor por qualificadores de recursos válidos.

    <AppxDefaultResourceQualifiers>Language={DefaultResourceLanguage}|Contrast=high|Scale=140|HomeRegion=419|TargetSize=256|
     LayoutDirection=LTR|DXFeatureLevel=DX10|Configuration=|AlternateForm=altform-msft-phonetic</AppxDefaultResourceQualifiers>

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

  5. Compile a solução.

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

  7. Verifique se os qualificadores que você adicionou aparecem no arquivo.

Consulte também

Definir recursos de aplicativo (aplicativos usando C#/VB/C++ e XAML)
Definindo recursos de aplicativo (aplicativos usando JavaScript e HTML)
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
Pacotes de aplicativos
Como decidir se é para gerar um pacote de aplicativos
Pacotes de recurso
Sistema de gerenciamento de recurso