Laboratório 1c: Adicionando arquivos e configurações do Registro a uma imagem

Artigo
10/15/2018

Criaremos alguns arquivos de teste e chaves do Registro para uma imagem do Windows IoT Core e os empacotaremos para que possam ser atendidos depois que forem distribuídos aos seus clientes. Como os arquivos e as chaves do Registro que você adiciona à sua imagem geralmente não são específicos de uma arquitetura, recomendamos criar um pacote comum que você possa usar em todas as arquiteturas de dispositivo.

Objetivos

Criar um pacote que contenha configurações de registro e arquivo para seu dispositivo
Empacotar o pacote de configurações de registro/arquivo para que ele possa ser incluído em uma imagem FFU
Modificar arquivos de configuração de projeto do Kit de Complemento IoT para incluir seu pacote de configurações de registro/arquivo
Compilar e implantar uma imagem FFU que contém seu pacote de configurações de registro/arquivo

Vamos criar alguns arquivos de teste e chaves do Registro para a imagem e empacotá-los novamente para que eles possam ser atendidos depois de alcançar seus clientes.

Vamos adicioná-los ao manifesto de recurso comum (OEMCommonFM.xml), que é usado em builds x86, x64 e Arm.

Para este laboratório, iniciaremos um novo produto, ProductB, para que posteriormente possamos usar o aplicativo de exemplo de IoT para obter o endereço IP do nosso dispositivo e verificar se nossos arquivos e chaves reg o fizeram.

Pré-requisitos

Verifique se você criou uma imagem básica de Criar uma imagem básica anteriormente.

Você precisará das seguintes ferramentas instaladas para realizar essa ação:

KiT de Avaliação e Implantação do Windows (Windows ADK)
Ambiente do PowerShell do IoT Core
Pacotes do Windows 10 IoT Core
ADK do IoT Core Add-Ons
Um editor de texto como o Bloco de Notas ou o VS Code.

Criar seus arquivos de teste

Crie alguns arquivos de texto de exemplo usando o Bloco de Notas e adicione algum texto aleatório para que esses arquivos não fiquem vazios. Para nosso exemplo, criamos dois arquivos intitulados TestFile1.txt e TestFile2.txt.

Criar um pacote para arquivos de teste

Abra o Ambiente do PowerShell do IoT Core: execute C:\MyWorkspace\IoTCorePShell.cmd como administrador e crie um pacote de arquivos usando Add-IoTFilePackage:
```
# Array of files with destinationDir, Source and destinationFilename
$myfiles = @(
    ("`$(runtime.system32)","C:\Temp\TestFile1.txt", ""),        
    ("`$(runtime.bootDrive)\OEMInstall","C:\Temp\TestFile2.txt", "TestFile2.txt")
    )
Add-IoTFilePackage Files.Configs $myfiles
```
Isso cria uma nova pasta em C:\MyWorkspace\Common\Packages\Files.Configs.

Isso também adiciona uma FILES_CONFIGS FeatureID ao C:\MyWorkspace\Common\Packages\OEMCOMMONFM.xml arquivo.

Variáveis como $(runtime.system32) são definidas em C:\Program Files (x86)\Windows Kits\10\Tools\bin\i386\pkggen.cfg.xml.

Crie um pacote do Registro usando Add-IoTRegistryPackage:

# Array of files with destinationDir, Source and destinationFilename
$myregkeys = @(
    ("`$(hklm.software)\`$(OEMNAME)\Test","StringValue", "REG_SZ", "Test string"),
    ("`$(hklm.software)\`$(OEMNAME)\Test","DWordValue", "REG_DWORD", "0x12AB34CD")
    )
Add-IoTRegistryPackage Registry.Settings $myregkeys

Isso cria uma nova pasta em C:\MyWorkspace\Common\Packages\Registry.Settings.

Isso também adiciona uma REGISTRY_SETTINGS FeatureID ao C:\MyWorkspace\Common\Packages\OEMCOMMONFM.xml arquivo.

Crie os pacotes usando New-IoTCabPackage:

New-IoTCabPackage Files.Configs
(or) buildpkg Files.Configs
New-IoTCabPackage Registry.Settings
(or) buildpkg Registry.Settings

O pacote foi criado e está disponível em C:\MyWorkspace\Build\<arch>\pkgs.

Criar um novo produto

Crie uma nova pasta de produto.
```
Add-IoTProduct ProductB RPi2
(or) newproduct ProductB RPi2
```
Isso solicitará que você insira valores SMBIOS .

Atualizar os arquivos de configuração do projeto

Atualize a configuração de teste de produto para incluir os recursos usando Add-IoTProductFeature:

Add-IoTProductFeature ProductX Test FILES_CONFIGS -OEM
(or) addfid ProductX Test FILES_CONFIGS -OEM
Add-IoTProductFeature ProductX Test REGISTRY_SETTINGS -OEM
(or) addfid ProductX Test REGISTRY_SETTINGS -OEM

Compilar e testar a imagem

Crie a imagem FFU novamente, conforme especificado em Criar uma imagem básica. Você só deve executar o comando New-IoTFFUImage :

New-IoTFFUImage ProductX Test
(or)buildimage ProductX Test

Depois que o arquivo FFu tiver sido criado, você poderá exibi-lo em seu dispositivo de hardware, conforme especificado em Piscando uma imagem do Windows IoT Core.

Verificar arquivos e chaves do Registro adicionados

Para verificar se os arquivos foram adicionados no dispositivo, faça o seguinte:

Conecte o computador técnico e o dispositivo à mesma rede ethernet.

Por exemplo, para se conectar por uma rede com fio, conecte um cabo ethernet. Para se conectar diretamente ao dispositivo, conecte um cabo de rede diretamente do computador técnico ao dispositivo.
No aplicativo de teste, observe o endereço IP do dispositivo. Por exemplo, 10.100.0.100.
No computador técnico, abra Explorador de Arquivos e digite o endereço IP do dispositivo com um sufixo \ prefixo e \c$:
```
\\10.100.0.100\c$
```

Use o nome do dispositivo, a conta de Administrador padrão e a senha para fazer logon. (O padrão é: minwinpc\Administrator/p@ssw0rd)

Verifique se os arquivos existem no dispositivo. Para nosso exemplo, procure:

\\10.100.0.100\c$\Windows\system32\TestFile1.txt

\\10.100.0.100\c$\OEMInstall\TestFile2.txt

Verificar chaves do Registro

No computador técnico, conecte seu dispositivo usando um cliente SSH, como PuTTY. Por exemplo, use o endereço IP e a porta 22 para se conectar ao dispositivo. Em seguida, faça logon usando a conta de administrador e a senha. (Para saber mais, confira SSH).
Na linha de comando no cliente SSH, consulte o sistema para obter a chave do Registro. Em nosso exemplo, esse comando foi executado para marcar a existência da chave do Registro:
```
reg query HKLM\Software\Fabrikam\Test
```
O cliente SSH deve exibir os valores de teste.

Como alternativa, você pode usar o comando Executar no Portal de Dispositivos do Windows para executar o reg query comando.

A janela de saída deve exibir os valores de teste.

Próximas etapas

Laboratório 1d: adicionar um pacote de provisionamento a uma imagem

Compartilhar via