Creating a Subproject

9/8/2008

Depois de criar um design sistema operacional (OS), você pode modificá-la adicionando ou removendo projetos. Um projeto é uma coleção de arquivos cujo implementar funções funcionalidade item Catálogo em um Windows Embedded CE 6.0 OS.

Um design OS contém todos os arquivos que compõem um executar-imagem tempo, incluindo subprojetos que você adicionar. Todos os subprojetos devem ser associado com um design OS que posteriormente é usada para compilar um executar-imagem tempo.

Em Platform Builder for Windows Embedded CE 6.0, você pode usar o CE 6.0 subprojeto Wizard para criar um subprojeto, que é fornecido um associado Platform Builder extensão de nome de arquivo projeto (.pbpxml). Um arquivo .pbpxml é um arquivo XML que serve como uma extensão camada fina de informações contidas no associado fontes arquivos sobre um subprojeto.

Em CE 6.0, informações sobre como subprojetos, incluindo origem codificar arquivo nomes e locais, estão contidas em arquivos Dirs e fontes. Para informações sobre esses tipos arquivo, consulte Sources File e Dirs File.

Este sistema permite que o usuário definir configurações específicas compilar na IDE mantendo a funcionalidade do IDE como um cliente fino para a subjacente sistema compilar.

Tipos de Subprojects

Você pode criar a seguinte tipos dos subprojetos em Platform Builder e especificar se eles são criados em um design OS, ou na árvore OS:

• Aplicativos
• Dinâmico-link Libraries (DLLs, bibliotecas dinâmico)
• Bibliotecas estáticas
• Camadas de transporte

Frameworks de desenvolvimento

Para o Windows Embedded CE OS, você pode usar Platform Builder para usar um do seguinte estruturas desenvolvimento no seu subprojeto:

• Modelo de Objeto Componente (COM)
• Active Template Library (ATL) 8.0 para Windows Embedded CE
• Estrutura Compact .NET 2.0

Exemplos, cabeçalho arquivos e arquivos biblioteca são nos diretórios %_WINCEROOT%\Others\DOTNETV2 e %_WINCEROOT%\Others\ATL8. Certifique-se de que incluir suporte para essas estruturas desenvolvimento no seu design OS. Itens Catálogo para essas estruturas estão localizados no Catálogo em CEBASE\Applications e Services Development.

Após esses subprojetos forem criados, você pode usar Platform Builder para adicioná-los para seu design OS.

Visão geral sobre a criação de subprojeto

Quando você cria um subprojeto usando o Windows Embedded CE subprojeto assistente, você deve selecionar um subprojeto específico tipo e especificar se ele é criado no Diretório PBWORKSPACEROOT % ou de Diretório _PUBLICROOT %.

As opções que são fornecidas pelo assistente variam, depending on o tipo do subprojeto que você criar.

Se você criar um subprojeto em % PBWORKSPACEROOT, o subprojeto é compilado somente no contexto desse design OS específico. Esta é a diferença entre esses subprojetos e subprojetos criados no _PUBLICROOT % somente.

Subprojetos criados em % _PUBLICROOT não dependem designs OS. Portanto, esses subprojetos são compilado cada tempo que a parte da árvore de OS estiverem em é um compilar.

A seguinte tabela mostra a disponível tipos subprojeto.

Subprojeto tipo	Descrição
Aplicativo WCE	Um do seguinte tipos: Um vazio subprojeto Um aplicativo baseado em Windows Embedded CE Um baseado em Windows Embedded CE aplicativo Hello World
WCE Console Application	Um aplicativo que é executado em um janela do console.
Biblioteca de Vínculo Dinâmico WCE	Um do seguinte tipos: Um vazio Windows Embedded CE DLL Uma simples Windows Embedded CE DLL Um DLL que exporta símbolos
Biblioteca estática WCE	Uma biblioteca estática Windows Embedded CE.
Camada de transporte WCE	Um subprojeto para uma camada transporte Device-side. Para exportar um personalizado SDK, crie um personalizado camada transporte. Este subprojeto também fornece a código-fonte de um subprojeto host-side.
Biblioteca de Vínculo Dinâmico tux WCE	Uma estrutura para um módulo que define um testar para o Windows Embedded CE Test Kit (CETK). O utilitário de teste tux para o CETK executa este módulo para adicionar a funcionalidade da testar para o CETK.
Subprojeto DIRS WCE	Um arquivo Dirs Windows Embedded CE. Não é possível associar esse tipo com um design OS.

Subprojeto arquivos de origem

Para a maioria dos subprojetos que você cria usando o assistente, o assistente gera um conjunto de origem arquivos que implementar a funcionalidade básica de seu subprojeto quando elas estiverem compilado. Esses arquivos incluem o seguinte:

• Arquivos de fonte e cabeçalho para o subprojeto
• Um arquivo de texto que descreve o conteúdo dos arquivos do iniciador
• Arquivos fontes que descrevam os arquivos na sua subprojeto

O assistente não gera arquivos origem Se você criar os seguinte itens:

• Um vazio aplicativo baseado em Windows Embedded CE
• Um vazio DLL
• Um arquivo Common Object File Format (COFF) que tem um extensão de nome de arquivo .lib e não contém um pré-compilado arquivo cabeçalho (.pch)
• Um arquivo Dirs

Durante a criação subprojeto, o assistente fornece opções para personalizar os arquivos de origem.

Após a criação subprojeto, você pode exibição o subprojeto arquivos no Gerenciador de Soluções expandindo Subprojetos.

Visão geral do processo de criação de subprojeto

Com Platform Builder, você pode compilar selecionado subprojetos. Porque cria ocorrer no segundo plano, você pode continuar a usar Platform Builder durante um compilar.

Observação

Alguns comandos menu e botões barra de ferramentas estão não disponível durante um compilar.

Antes de compilar um subprojeto, você escolher o ativo design OS, que determina qual conjunto de opções compilar é usado. De exemplo, as opções selecionadas compilar uma configuração versão diferem das opções selecionadas em uma depuração configuração.

Para obter informações sobre as opções compilar que você pode selecionar, consulte Build Menu Options.

Se, enquanto ele está compilação um subprojeto, Platform Builder determina que os cabeçalhos estão desatualizados, aparece uma caixa diálogo que exibe a seguinte três opções:

• Criar o subprojeto com cabeçalhos regenerados
• Criando o subprojeto sem regenerar os cabeçalhos
• Cancelando a processo de criação

As informações sobre a compilar aparecem na Saída Guia das Saída janela na IDE. A guia exibe informações das ferramentas compilar e lista os erros ou avisos ocorridos durante a compilar.

Não se houver nenhuma atividade na Saída guia, você pode monitor de status a partir de barra de status, que exibe a Edifício ícone durante a compilar.

Se a guia Relatórios sem erros, a compilar será concluída com êxito.

Se a guia relata erros, talvez seja necessário para executar depuração após a compilar completo.

Quando o processo de criação estiver completo, Platform Builder notificá-lo com um bipe. Se você tiver um som cartão instalado, você pode usar o Sons ícone em Control Panel para atribuir sons diferentes para padrão três eventos sistema, mostrados a seguinte tabela.

Evento do sistema	Descrição
Compilação concluída	A compilar concluída sem erros ou avisos.
Criar aviso	A compilar concluída com avisos.
Criar erro	A compilar concluída com erros.
Erro na saída	Erro na compilar.
Aviso na saída	Ocorreu um aviso de saída.

Esta seção

• Creating a New Subproject
  Descreve como criar um subprojeto e adicioná-lo para seu design OS.

• Using Managed Code in a Subproject
  Descreve como usar código gerenciado, que tem como alvo o Common Language Runtime, em um subprojeto.

• Preparing to Build a Subproject
  Descreve como se preparar para compilar um subprojeto após ter criado um subprojeto em um design OS.

• Configuring Subproject Build Order
  Descreve como configurar a ordem que os subprojetos são interno.

Seções relacionadas

• Building a Subproject
  Descreve como compilar um subprojeto usando o Platform Builder IDE.

• Building a Selected Subproject
  Descreve como compilar um subprojeto específico independently of o design OS e de outros subprojetos no design de OS.

• Building Multiple Subprojects
  Descreve como compilar múltiplo consecutivamente subprojetos usando o Platform Builder IDE.

See Also

Concepts

Modifying an OS Design

Other Resources

Sysgen Tool