Sysgen Tool
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
A ferramenta Sysgen (Sysgen.bat) cria um personalizado Windows Embedded CE OS usando as configurações especificadas em Cesysgen.bat. Ele usa Nmake.exe para criar os módulos especificados em Cesysgen.bat vinculando juntos o .lib arquivos que corresponder à funcionalidade especificada em Cesysgen.bat.
Observação
Cebuild.bat chama essa ferramenta. Você não normalmente deve chamar diretamente essa ferramenta. Para executar Sysgen.bat corretamente para todas as árvores OS usadas pelo seu design OS, executar cebuild - q Em vez disso. A seguinte documentação é fornecida para a abrangência e fins informativos somente.
Após verificar que existe um arquivo Cesysgen.bat no Diretório %_PROJECTROOT%\Oak\Misc, Sysgen.bat define o apropriado variáveis ambiente para a funcionalidade especificada em Cesysgen.bat.
Sysgen.bat, em seguida, chama que usa as regras no arquivo de makefile, localizado no Diretório %_WINCEROOT%\Public\Common\Cesysgen, Nmake.exe ou, se a -p Opção projeto é especificada no arquivo makefile, no Diretório de \Cesysgen %_WINCEROOT%\OSDesigns\ <Project Name >, fazer o seguinte:
Crie diretórios sistema qualquer destino que ainda não existirem.
Criar os módulos especificados em Cesysgen.bat vinculando o .lib arquivos que corresponder à funcionalidade especificada para cada módulo em Cesysgen.bat.
Chamar a ferramenta Resource Combining (Res2res.exe) para combinar os arquivos de recurso para todas as funcionalidades especificada em Cesysgen.bat. Sysgen.bat chama Res2res.exe uma vez para cada linguagem.
Chamar a ferramenta Resource Check (Checkres.exe) e a ferramenta Resource Merge (Rebaseic.exe) para combinar múltiplo binário arquivos recurso (. res) em um arquivo. res único e correção qualquer conflitante identificadores recurso. Durante esse processo, o seguinte aviso pode ser exibido:
Did not find a redirect resource.Você pode ignorar essa mensagem.
Chame a ferramenta Feature Filter (Cefilter.exe) para preprocess os arquivos cabeçalho Windows Embedded CE e outros arquivos diversos origem antes de módulos selecionados são vinculados.
Os arquivos Windows Embedded CE cabeçalho e o comum arquivos contêm linhas comentar com marcas especiais que usa Cefilter.exe para pré-processamento.
Essas marcas são gravadas na linguagem de marca @CESYSGEN. A sintaxe dessa linguagem inclui instruções condicionais; de exemplo, lógico - e, lógico - ou e condições lógicas-não. Se você editar ou remover essas marcas, erros inesperados irá ocorrer.A seguinte tabela mostra os arquivos que chama Cefilter.exe para pré-processamento e localidade desses arquivos Após processamento está completo.
Arquivos de entrada de % _COMMONPUBROOT % Diretório de Saída em % _PROJECTROOT % Sdk\Inc\*.*
Cesysgen\Sdk\Inc
Oak\Inc\*.*
Cesysgen\Oak\Inc
Ddk\Inc\*.*
Cesysgen\Ddk\Inc
Oak\Files\Common\*.*
Cesysgen\Oak\Files
Copiar módulos **que não têm correspondente Catálogo itens ** no apropriado diretórios destino.
Sysgen.bat coloca os arquivos resultantes em vários subdiretórios do _PROJECTROOT%\Cesysgen %.
Sysgen.bat coloca informações de erro o arquivo Build.log no Diretório % _WINCEROOT %.
sysgen [-h] [-b] [-c] [-p Tree][NmakeTarget] [NmakeTarget] ...
Parâmetros
-h
Exibe uma Tela de ajuda.
-b
Usado para chamadas internas somente.
-c
Executa Nmake.exe com o-Limpaparâmetro.
-pÁrvore
Executa Sysgen.bat no projeto especificado. Se nenhum projeto é especificado, Sysgen.bat será executado no projeto comum, que cria a funcionalidade Windows Embedded CE núcleo.
Especifica um módulo específico para compilar. Se NmakeTarget não for especificado, Nmake.exe cria todos os módulos listados em Cesysgen.bat. Normalmente, você não deve usar esse parâmetro, porque um dispositivo destino com somente um projeto pode estar incompleto.
Você pode utilizar NmakeTarget para especificar um destino especial, bem como um módulo. A seguinte tabela descreve os destinos especiais que podem ser usados como parâmetros ** NmakeTarget.
| Valor | Descrição |
|---|---|
|
Copia os arquivos Common.* filtrados para o local Diretório destino. |
|
Copia os arquivos incluem filtrada para o local diretórios destino. |
|
Cria arquivos NLS e os copia para o local Diretório destino. |
|
Copia os arquivos página de código para o local Diretório destino. |
Mensagens de erro
- Erro: Projeto cesysgen.bat específico não encontrado. Crie um cesysgen.bat em %_PROJECTROOT%\oak\misc
Sysgen.bat depende Cesysgen.bat para especificar a funcionalidade para o projeto Windows Embedded CE. Sysgen.bat procura Cesysgen.bat em % _PROJECTROOT%\Oak\Misc. Para solucionar problemas, não se esqueça Cesysgen.bat reside neste Diretório.
Quaisquer erros adicionais durante a execução dessa ferramenta aparecem no arquivo Build.log, localizado no Diretório % _WINCEROOT %.
Exemplos
O seguinte exemplo de código mostra como usar Sysgen.bat para chamar Nmake.exe criar diretórios sistema destino como exigido, compilar ou link funcionalidade Windows Embedded CE núcleo e funcionalidade núcleo copiar para o local áreas destino.
sysgen
O seguinte exemplo de código mostra como usar Sysgen.bat para chamar Nmake.exe para compilar ou link funcionalidade shell Windows Embedded CE e copiá-los para o local áreas destino.
sysgen -p wceshell