Como usar um arquivo personalizado para passar informações do OEM (HTML)

  • Artigo

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

Desenvolva um aplicativo que use um arquivo personalizado para transmitir informações do OEM para o aplicativo.

Para os aplicativos que você cria para implantação do OEM, você pode usar um arquivo personalizado para transmitir informações do OEM para os aplicativos. Para transmitir informações do OEM para um aplicativo, crie um arquivo Custom.data na pasta microsoft.system.package.metadata. Esse nome de arquivo é especial para o sistema operacional e é automaticamente transferido durante as atualizações. Os OEMs podem usar esse arquivo para transmitir identificadores personalizados, para que os aplicativos saibam quando foram implantados pelos OEMs. Você pode ter apenas um arquivo Custom.data por aplicativo. Os aplicativos devem ser capazes de procurar e ler esse arquivo corretamente. Os desenvolvedores tratam o arquivo como dados não confiáveis.

O que você precisa saber

Tecnologias

Pré-requisitos

Instruções

Etapa 1: Criar um arquivo personalizado e adicioná-lo à pasta de metadados do pacote

Você pode criar seu aplicativo para usar qualquer formato que você escolher para os dados personalizados. Por exemplo, você pode usar XML, um arquivo de texto ou outro tipo de arquivo para organizar seus dados. Nós recomendamos que você considere como pode testar e validar o arquivo. Por exemplo, você pode criar um esquema XML para validar um arquivo XML.

Você pode especificar qualquer tipo de arquivo com qualquer nome de arquivo para os dados personalizados. Quando você adiciona o pacote do aplicativo com o arquivo de dados personalizado usando a ferramenta DISM, a DISM renomeia o arquivo personalizado como Custom.data e o salva na pasta microsoft.system.package.metadata.

Observação  O arquivo de dados personalizado não pode ser modificado pelo aplicativo. Trata-se de um recurso somente leitura.

 

Etapa 2: Acessar o arquivo de dados personalizado para um aplicativo

Você pode acessar o arquivo Custom.data para um aplicativo em seu código usando as APIs do Windows para obter informações para o pacote atual. Por exemplo:

Windows.ApplicationModel.Package.current.installedLocation.getFileAsync(
"microsoft.system.package.metadata\\custom.data")

Para obter mais informações sobre o desenvolvimento com a propriedade Package.Current, veja Início rápido: consultar informações do manifesto do pacote do aplicativo.

Para saber mais sobre como acessar o arquivo custom.data via IStorageFolder.GetFileAsync e usando objetos StorageFile, veja Acessando dados e arquivos.

Tópicos relacionados

Início rápido: consultar informações do manifesto do pacote do aplicativo