Compartilhar via

Adicionar aplicativos à imagem do sistema operacional de fábrica

  • Artigo

O Kit de Sistema do Windows inclui scripts para ajudar a facilitar a adição de Aplicativos Universais do Windows às imagens do sistema operacional de fábrica. Esses scripts criam ou atualizam automaticamente um arquivo de Manifesto de Recurso com base nos aplicativos que você adiciona a um workspace.

Para adicionar aplicativos a uma imagem que já está em execução, consulte Conectar usando o Portal de Dispositivos.

Pré-requisitos

  • Um workspace do WSK
  • Um ou mais Aplicativos Universais do Windows empacotados corretamente

Reunir seus aplicativos

  1. Reúna todos os arquivos .msix, .msixbundles, .appx e .appxbundle, incluindo todos os arquivos de dependência e licença, para todas as arquiteturas compatíveis com seu aplicativo (x64, x86 e arm) no computador técnico.

  2. Salve os aplicativos na pasta Aplicativos padrão em seu workspace, por exemplo: C:\Workspace\Apps\. Se seus aplicativos estiverem em suas próprias pastas, não há problema em usar subpastas. Os scripts podem encontrar seus aplicativos.

    Também não há problema em ter vários aplicativos que incluam o mesmo arquivo de dependência. O arquivo de dependência só será adicionado uma vez à imagem final.

    Nosso exemplo usa o aplicativo Calculadora que é agrupado ao longo do WSK como um aplicativo UWP (Plataforma Universal do Windows fornecido pela Microsoft). Você pode usar os aplicativos de exemplos de aplicativo UWP ou substituí-los por seus próprios aplicativos.

Adicionar aplicativos ao AppFM incluído em seu workspace

Seu workspace inclui um App FM vazio que já está incluído no arquivo OEMInput.xml. Para adicionar aplicativos a uma imagem, use os scripts no WSK para adicionar aplicativos ao App FM. Se não quiser usar este FM e quiser saber como criar um novo aplicativo FM e incluí-lo em um arquivo OEMInput.xml, consulte Criar um novo Aplicativo FM.

Adicione aplicativos ao App FM do workspace:

  1. Inicie o Ambiente de Build do Kit de Sistema do Windows como administrador (por exemplo, no ISO do WSK montado, clique com o botão E:\SetImagGenEnv.cmd direito do mouse e clique em Executar como administrador.)

  2. No ambiente de build do Kit de Sistema do Windows, navegue até a pasta do workspace:

    cd c:\Workspace

  3. Defina a variável raiz do workspace para apontar para Atualizar a variável de ambiente WSKWorkspaceRoot para apontar para o workspace.

    C:\Workspace\SetWSKWorkspaceRoot.cmd

  4. Adicione os aplicativos em seu workspace ao Aplicativo FM incluído: use os scripts no WSK para atualizar seu App FM para que ele inclua os aplicativos em seu workspace.

    Execute o UpdateWSKAppsFM script para adicionar todos os aplicativos na pasta de aplicativos do workspace (%WSKWorkspaceRoot%\Apps) ao OEMAppsFM.xml. Todos os aplicativos listados neste FM serão incluídos em sua imagem.

    UpdateWSKAppsFM

    Se você não especificar nenhuma opção, o script atualizará o %WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml arquivo para incluir todos os aplicativos na pasta Aplicativos do workspace. Para obter opções de script, consulte Sintaxe UpdateWSKAppsFM abaixo.

    Por padrão, os aplicativos são incluídos em todos os designs de imagem, mas você pode adicionar identificadores de aplicativo e marcar aplicativos como opcionais se estiver criando vários designs de imagem usando um conjunto centralizado de garantias.

    Ao adicionar, remover ou atualizar seus aplicativos, execute novamente UpdateWSKAppsFM para adicionar alterações ao manifesto do recurso. Não há problema se você fez outras edições no manifesto do recurso, por exemplo, definindo um aplicativo como opcional. O script não afetará essas alterações.

Criar um novo Aplicativo FM

Você pode usar os scripts no Kit de Sistema do Windows para criar um novo App FM:

No ambiente do Kit de Sistema do Windows:

  1. Coloque os aplicativos que você deseja incluir em uma pasta.

  2. Execute o CreateWSKAppsFM script para incluir todos os aplicativos na pasta do aplicativo. Especifique o nome do novo AppFM e a pasta de aplicativos:

    CreateWSKAppsFM -fmfile %WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml -AppsFolder C:\NewApps

    Para obter opções de script, consulte Sintaxe CreateWSKAppsFM abaixo.

    Esse script cria um novo arquivo de manifesto de recurso, por exemplo, %WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml que contém o local de cada um dos aplicativos.

    Por padrão, os aplicativos são incluídos em todos os designs de imagem, mas você pode adicionar identificadores de aplicativo e marcar aplicativos como opcionais se estiver criando vários designs de imagem usando um conjunto centralizado de garantias.

  3. Adicione o novo App FM ao arquivo OEMInput.xml adicionando-o como um <AdditionalFM>:

    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml</AdditionalFM>

  4. Se você adicionar, remover ou atualizar seus aplicativos, execute UpdateWSKAppsFM para adicionar os aplicativos ao manifesto do recurso. Não há problema se você fez outras edições no manifesto do recurso, por exemplo, definindo um aplicativo como opcional. O script não afetará essas alterações:

    UpdateWSKAppsFM -fmfile %WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml -AppsFolder C:\NewApps

Sintaxe de scripts FM do aplicativo

Sintaxe CreateWSKAppsFM

CreateWSKAppsFM {-FMFile: [path]} {-AppsFolder [Path]} {-IncludeWow}
Parâmetro Descrição
-FMFile [Caminho] Caminho para o arquivo FM que você deseja criar. Por padrão, atualiza %WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml.
-AppsFolder [Caminho] Caminho para a pasta na qual você deseja pesquisar aplicativos. Por padrão, pesquisa %WSKWorkspaceRoot%\Apps.
-IncludeWow Adiciona suporte para x86 em imagens amd64 e suporte para arm em imagens arm64.

Sintaxe UpdateWSKAppsFM

UpdateWSKAppsFM {-FMFile: [path]} {-AppsFolder [Path]} {-IncludeWow}
Parâmetro Descrição
-FMFile [Caminho] Caminho para o arquivo FM que você deseja atualizar. Por padrão, cria ou substitui %WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml.
-AppsFolder [Caminho] Caminho para a pasta na qual você deseja pesquisar aplicativos. Por padrão, pesquisa %WSKWorkspaceRoot%\Apps.
-IncludeWow Se definido, ele adicionará x86 a amd64, arm para imagens arm64.