Windows Embedded CE Build Environment Tool

9/8/2008

Wince.bat prepara o ambiente compilar estação de trabalho desenvolvimento usando entrada três parâmetros para determinar o ambiente compilar, a localidade de arquivos de origem usados durante a processo de criação e os arquivos criados durante a processo de criação.

Quando Wince.bat for executado na janela de compilar prompt de comando, ele usa a seguinte entrada três parâmetros para definir variáveis de ambiente específico para o projeto.

• % _TGTCPU %
• % _TGTPROJ %
• % _TGTPLAT %

Essas variáveis são usadas em todo o processo de criação para compilar o apropriado destinos.

Observação

Se falhar Setdrive.exe ou Setdrv.bat, Wince.bat falhará.

Se a seguinte ambiente variáveis não estiverem definidas antes que seja Wince.bat define executar, Wince.bat-los para seus valores usar como padrão.

set _FLATRELEASEDIR=%_WINCEROOT%\release
set _PROJECTROOT=%_PUBLICROOT%\%_TGTPROJ%

% _WINCEROOT % deve ser definido antes execução Wince.bat. Caso contrário, Wince.bat relata um erro e sai.

Wince.bat continua a definir uma série de ambiente variáveis. Além disso, Wince.bat chama vários arquivos lote, que também podem conter variáveis ambiente. A seguinte tabela mostra os arquivos de lote que chamadas Wince.bat.

Arquivo em lotes	Descrição
SETENV.bat	Define variáveis ambiente particular para a janela compilar. Este valor deve ser em Diretório de %_WINCEROOT%\Developr\%USERNAME%.
%_TGTPLAT%.bat	Define design OS-dependente variáveis ambiente relacionado para o design OS. Este valor deve ser em Diretório de %_WINCEROOT%\Platform\%_TGTPLAT%.
%_TGTPROJ%.bat	Projeto conjuntos-dependente ambiente variáveis. Cada configuração e demonstração pasta projeto no Diretório público contém um arquivo em lotes nomeado após o correspondente projeto. Este valor deve ser no Diretório % _PROJECTROOT %.
%_WINCEROOT%\Setdrv.bat	Define a unidade estação de trabalho desenvolvimento para o projeto Windows Embedded CE.
%_WINCEROOT%\Public\Common\Oak\Misc\Etkenv.bat	Incondicionalmente define IMGNODEBUGGER como 1.

Esses opcional lote arquivos permitem mais personalização do processo de criação independentemente as configurações usar como padrão em Wince.bat. Wince.bat valida individual variáveis ambiente, mas não garante que a combinação de parâmetros correspondências.

Antes de modificar o local ou Wince.bat lote arquivos que são usados por Wince.bat, para obter mais informações, consulte Environment Variables.

Após as variáveis de ambiente são definidas, Wince.bat cria o Diretório % _FLATRELEASEDIR %. Wince.bat e verifica a presença de determinados arquivos .bif no Diretório % _FLATRELEASEDIR % que contêm o atual parâmetros do seu projeto Windows Embedded CE.

A seguinte tabela mostra os arquivos .bif e sua localidade.

Criar arquivo de informações	Local
%_TGTPROJ%.bif	% _FLATRELEASEDIR %
%_TGTPLAT%.bif	% _FLATRELEASEDIR %
%_TGTCPU%.bif	% _FLATRELEASEDIR %
%_TGTPROJ%.bif	Platform\%_TGTPLAT%

Se esses arquivos .bif não estiverem presentes, Wince.bat cria os arquivos .bif o Diretório % _FLATRELEASEDIR % e continua configuração o ambiente compilar.

Se existirem esses arquivos .bif, Wince.bat usa sua presença como um sinalizador para indicar que exista um Diretório % _FLATRELEASEDIR %.

Wince.bat verifica que o atual variáveis compilar, % _TGTCPU %, % _TGTPROJ % e % _TGTPLAT %, são compatível com o atual processo de criação. Se não forem compatível, Wince.bat exibe uma mensagem aviso e não copiar automaticamente compilar resultados para o Diretório % _FLATRELEASEDIR %.

    [] [_TGTCPU] [_TGTPROJ] [_TGTPLAT] [PRIVATE_OPTIONS]

Comentários

Observação

Os parâmetros wince São com diferenciação de maiúsculas e minúsculas.

Parâmetros

• -h
  Exibe um arquivo da Ajuda de Wince.bat.

• _TGTCPU
  O CPU específica que os destinos compilar.

• _TGTPROJ
  O nome do diretório design OS que usa a compilar.

• _TGTPLAT
  A placa suporte pacote (BSP) em que o design OS baseia e quais os destinos processo de criação. BSPs disponíveis em seu desenvolvimento estação de trabalho são instalados na Diretório %_WINCEROOT%\Platform.

  A seguinte lista contém o válido Parâmetros:

  • NOPLAT
  • <BSP_Name >

  Se definido, NOPLAT fará com que a árvore OS ser compilado sem compilação a executar-imagem tempo. Isso permite que você otimizar o processo de desenvolvimento quando você trabalho com múltiplo BSPs que usam o mesmo CPU.

  Você codificar origem compilar na árvore OS uma vez e, em seguida, compilar somente codificar BSP-specific alterando o Diretório destino para o Diretório BSP você desejar e execução compilar comandos de uma linha de comando prompt.

• PRIVATE_OPTIONS
  Os parâmetros adicionais são passados sem interpretação para SETENV.bat.

For Windows Embedded CE:

• _TGTCPU
  O CPU específica que os destinos compilar. A seguinte lista contém o válido Parâmetros:

  ARM	ARMV4I	MIPS16	MIPSII
  MIPSII_FP	MIPSIV	MIPSIV_FP	SH4
  X 86	NT	NTANSI

Mensagens de erro

Esta janela compilar é incompatível com o atual versão Diretório. A variável WINCEREL está sendo forçado desativar a evitar liberando os binários automaticamente. Você deve fazer um "buildrel" Para reinicializar o Diretório versão para a atual configuração.

Se um tipo de binário é copiado para o Diretório versão e Wince.bat é executar com parâmetros que não são compatível com os binários existentes, Wince.bat emite essa mensagem de erro e finaliza a processo de criação.

Para ter múltiplo ativo diretórios versão, seja modificar SETENV.bat para atribuir um Diretório diferente para o variável de ambiente % _FLATRELEASEDIR % ou excluir o Diretório existente, % _WINCEROOT%\Release.

Exemplo

For Windows Embedded CE:

O seguinte mostra como usar Wince.bat para configurar um ambiente projeto para um membro do x 86 família CPU exemplo de código. O Diretório projeto é Myproj e de destino para a plataforma hardware CEPC.

wince x86 MYPROJ CEPC

Comentários

Wince.bat define muitas variáveis ambiente para o ambiente compilar Windows Embedded CE.

Antes execução Wince.bat, verificar que a entrada três parâmetros têm válido nomes e são apresentados em sua ordem correta. A entrada Parâmetros são com diferenciação de maiúsculas e minúsculas.

Execute as janelas compilar prompt de comando para verificar que as variáveis de ambiente válido. Não se esqueça que _WINCEROOT está definido.

Execute Wince.bat de um janela do prompt de comando que executa a partir % _WINCEROOT%\Public\Common\Oak\Misc.

See Also

Concepts

Environment Variables
Set Environment Variable Tool

Other Resources

Building a CEPC Run-Time Image for Use with an Ethernet Card
Building a Run-time Image Using the Build Demo Tool