Compartilhar via


Criar e instalar um pacote

Os pacotes são os blocos de construção de Windows 10 IoT Core. De drivers de dispositivo a arquivos do sistema, cada componente deve ser empacotado para instalar em um dispositivo. Os pacotes são as menores unidades de manutenção no dispositivo.

Etapa 1: Configurar

Instalar as ferramentas

  1. Kit de Avaliação e Implantação do Windows (Windows ADK)
  2. Complementos do ADK do IoT Core

Configurar seu ambiente

  • Launch IoTCorePShell.cmd ( este é iniciado no prompt com privilégios elevados )
  • Criar um novo workspace usando new-ws C:\MyWorkspace <oemname> <arch>

Para criar sua própria imagem (FFU), siga as etapas descritas no laboratório "Criar uma imagem básica" no guia de Fabricação de IoT.

Etapa 2: Criar um novo pacote

  1. Crie um arquivo xml de definição de pacote (arquivo .wm.xml) e especifique os arquivos e as chaves de reg que você deseja adicionar. Saiba mais em Esquema de Pacote OEM Universal do Windows.

  2. Compile o pacote: buildpkg filename.wm.xml. O arquivo .cab será criado no diretório <workspace>\Build\<arch>\pkgsde build .

Criar um pacote com arquivos e chaves reg

Veja abaixo um exemplo para especificar arquivos e chaves reg.

<?xml version="1.0" encoding="utf-8"?>
<identity xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    name="SUBNAME" namespace="COMPNAME" owner="Contoso" legacyName="Contoso.COMPNAME.SUBNAME" 
    xmlns="urn:Microsoft.CompPlat/ManifestSchema.v1.00">
    <onecorePackageInfo
        targetPartition="MainOS"
        releaseType="Production"
        ownerType="OEM" />
    <regKeys>
        <regKey
            keyName="$(hklm.software)\Contoso\Test">
            <regValue name="StringValue" type="REG_SZ" value="Test string" />
            <regValue name="DWordValue" type="REG_DWORD" value="0x12AB34CD" />
            <regValue name="BinaryValue" type="REG_BINARY" value="12ABCDEF" />
        </regKey>
        <regKey
            keyName="$(hklm.software)\Contoso\EmptyKey" />
    </regKeys>
    <files>
        <file
            destinationDir="$(runtime.system32)"
            source="filename.txt" />
        <file
            destinationDir="$(runtime.bootDrive)\OEMInstall"
            source="filename2.txt"
            name="filename2.txt" />
    </files>
</identity>

Criar um pacote Appx

Use Add-IoTAppxPackage para gerar o arquivo .wm.xml para um determinado arquivo appx. Essa ferramenta espera as dependências appx no subdiretório chamado "dependências" na pasta que contém o arquivo appx.

Add-IoTAppxPackage HelloWorld.appx fga Appx.HelloWorld
(or) newappxpkg HelloWorld.appx fga Appx.HelloWorld
New-IoTCabPackage Appx.HelloWorld
(or) buildpkg Appx.HelloWorld

fga define o appx como o aplicativo de inicialização em primeiro plano, bgt define o appx como a tarefa em segundo plano e none ignora a configuração de inicialização. Para ferramenta de linha de comando mais antiga, consulte newappxpkg.cmd

Confira Appx.IoTCoreDefaultApp como exemplo.

Quando você precisa instalar vários aplicativos assinados com o mesmo certificado, você pode adicionar o certificado junto com um aplicativo e, para os aplicativos restantes, você pode ignorar a adição do certificado usando o sinalizador skipcert.

newappxpkg AnotherApp.appx none Appx.AnotherApp skipcert

Confira também

Criar um pacote de driver

O pacote de driver contém as referências (InfSource) ao arquivo Inf do driver. Você pode criar o arquivo .wm.xml do driver manualmente ou usar Add-IoTDriverPackage que gera xml de pacote com base no arquivo inf de entrada.

Add-IoTDriverPackage C:\Mydriver\GPIO.inf MyDriver.GPIO
(or) newdrvpkg C:\Mydriver\GPIO.inf MyDriver.GPIO
New-IoTCabPackage MyDriver.GPIO
(or) buildpkg MyDriver.GPIO

Para a ferramenta de linha de comando mais antiga, use inf2cab.cmd cria o arquivo xml do pacote e também cria o arquivo cab diretamente invocando buildpkg.cmd internamente.

Observação

O Windows IoT Core dá suporte apenas ao Inf Universal.

Confira também

Etapa 3: Instalar no dispositivo


  • Conectar-se ao dispositivo (usando SSH ou usando o PowerShell)
  • Copie o <filename>.cab arquivo para o dispositivo para um diretório, digamos C:\OemInstall
  • Inicie o preparo do pacote usando applyupdate -stage C:\OemInstall\<filename>.cab. Observe que essa etapa é repetida para cada pacote, quando você tem vários pacotes para instalar.
  • Confirme os pacotes usando applyupdate -commit.

Observação

Você também pode instalar o cab usando Windows Update > opção cab install no Portal de Dispositivos do Windows. O dispositivo será reiniciado no sistema operacional de atualização (mostrando engrenagens) para instalar os pacotes e será reiniciado novamente para main sistema operacional. Esse processo pode levar alguns minutos.