Catalog Item Dependencies
.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
Durante a criação design OS e personalização, Platform Builder chama a ferramenta Cesysgen (Cesysgen.bat), que usa variáveis Sysgen durante a fase Sysgen do processo de criação para determinar a inclusão ou exclusão de itens em seu design OS Catálogo.
Para obter mais informações sobre o relacionamento entre itens Catálogo e Sysgen variáveis, consulte Sysgen Variables.
Determinando a inclusão ou exclusão de itens em seu design OS Catálogo é obtida com a lógica contida em Cesysgen.bat que especifica quais outro Catálogo itens um Catálogo específico requer item. Você pode determinar as dependências de um Catálogo item examinando Cesysgen.bat. Para obter mais informações, consulte Cesysgen Batch File.
Se você remover um Catálogo específico item de seu design OS e Platform Builder traz o Catálogo item voltar no seu design OS, isso significa que Catálogo outro item requer o Catálogo item para função. Para remover um Catálogo item do seu design OS, você deve primeiro remover todos os itens Catálogo que dependem dele.
Para exemplo, suporte modem requer Protocolo ponto a ponto (PPP) para função corretamente. Isso significa que incluindo o Catálogo item para suporte modem também define a variável Sysgen, SYSGEN_MODEM. Isso resulta na configuração da variável de Sysgen SYSGEN_PPP para PPP por dependência.
Alguns recursos podem não ser incluídos em um design OS porque o design é compilado com a suposição que a Catálogo item é sempre incluído, ou porque o design OS não suporte o Catálogo item. De exemplo, um design OS com base em um modelo design Tiny Kernel pode não ter sem fio sistema de rede funcionalidade porque ele não é com suporte Por padrão.
Durante a fase Sysgen, um programa de filtragem filtros cabeçalho (.h), binário construtor imagem (.bib), e Registro (. reg) arquivos que corresponder a esses itens Catálogo de acordo com se e instruções endif que dividem-los em componentes. Em seguida, o programa de filtragem copia as filtrados versões desses arquivos para %_WINCEROOT%\OSDesigns\ < MyOSDesign >.
O seguinte exemplo de código mostra comentários a partir de _WINCEROOT%\Public\Common\Oak\Inc\Netui.h % arquivo de cabeçalho.
//@CESYSGEN IF CE_MODULES_NETUI
//@CESYSGEN ENDIF
Qualquer codificar dentro esta se/endif declaração é eliminada fora durante a fase Sysgen, a menos que o componente NETUI é adicionado ao CE_MODULES em Cesysgen.bat. Em seguida, o arquivo filtrado é copiado para \Cesysgen\Oak\Inc ** < MyOSDesign > %_WINCEROOT%\OSDesigns\.
O seguinte exemplo de código mostra comentários a partir de _WINCEROOT%\Public\Common\Sdk\Inc\Winuser.h % arquivo de cabeçalho.
// @CESYSGEN IF GWES_TIMER
// @CESYSGEN ENDIF
Qualquer codificar dentro esta se/endif declaração é eliminada fora durante a fase Sysgen, a menos que o componente timer é adicionado para GWES_COMPONENTS. Em seguida, o arquivo filtrado é copiado para \Cesysgen\Sdk\Inc ** < MyOSDesign > %_WINCEROOT%\Public\.
Listas de componente com _MODULES em seus nomes se tornam destinos link para arquivos makefile Sysgen, que são geralmente em \Cesysgen\Makefile ** %_WINCEROOT%\Public\ DependencyTree. Os componentes nessas listas determinam quais bibliotecas Platform Builder ficar binários.
De exemplo, se você adicionar o componente NETUI para CE_MODULES em Cesysgen.bat, durante a fase Sysgen a ferramenta Nmake executa as ações arquivo makefile exigido para compilar o componente.
Para obter informações sobre a ferramenta Nmake, consulte Nmake Tool. Para obter informações sobre makefiles, consulte Makefile File.
Você pode personalizar um Catálogo item após adicioná-lo para seu design OS modificando o associado configurações Registro COM que Catálogo item. Para informações sobre personalização disponível para cada Catálogo item, consulte Windows Embedded CE Architecture.
Configurações de cada item são Catálogo Registro usar como padrão armazenadas em ambos os %_WINCEROOT%\Public\ DependencyTree\Oak\Files\DependencyTree.reg, ou em %_WINCEROOT%\Platform\** MyBSP \Files\Platform.reg.
Você pode substituir as configurações Registro usar como padrão um por-base design OS modificando arquivos do design de OS Registro. Principal do design de OS Registro arquivo está em % _PROJECTROOT%\Oak\Files\Project.reg.
See Also
Concepts
Catalog Item Management
Command-Line Catalog Item Dependencies
Resolving an IDE Catalog Item Dependency