Compartilhar via


Como desenvolver um aplicativo OEM que usa um arquivo personalizado

Para obter mais informações sobre como criar e usar arquivos de dados personalizados, consulte Opções de linha de comando de manutenção do pacote de aplicativo DISM (.appx ou .appxbundle).

Saiba como desenvolver um aplicativo que usa um arquivo personalizado para passar informações do OEM para o aplicativo.

Para aplicativos criados para implantação de OEM, você pode usar um arquivo personalizado para passar informações do OEM para os aplicativos. Para passar 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 é transferido automaticamente durante as atualizações do sistema operacional. Os OEMs podem usar esse arquivo para passar identificadores personalizados, para que os aplicativos saibam quando os OEMs os implantaram. 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 arquivo personalizado e adicioná-lo à pasta de metadados do pacote

Você pode projetar seu aplicativo para usar qualquer formato que escolher para os dados personalizados. Por exemplo, você pode usar XML, um arquivo de texto ou outro tipo de arquivo para organizar seus dados. 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, o DISM renomeia o arquivo personalizado para Custom.data e salva o arquivo na pasta microsoft.system.package.metadata.

Observação

O arquivo de dados personalizado não pode ser modificado pelo aplicativo. É um recurso somente leitura.

 

Etapa 2: acessar o arquivo de dados personalizado de um aplicativo

Você pode acessar o arquivo Custom.data de um aplicativo a partir do seu código usando 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 saber mais sobre como desenvolver com a propriedade Package.Current, veja Guia de início rápido: consultar informações de manifesto do pacote do aplicativo.

Para obter mais informações sobre como acessar o arquivo custom.data via IStorageFolder.GetFileAsync e usando objetos StorageFile, consulte Acessando dados e arquivos.

Guia de início rápido: consultar informações de manifesto do pacote do aplicativo