Alterando o código do componente

Ao especificar os componentes para uma instalação, os autores de pacotes devem seguir as regras gerais para a organização de componentes descritas em Organizando aplicativos em componentes. Os autores podem precisar introduzir novos componentes ou modificar componentes existentes. Se a adição, remoção ou modificação de recursos efetivamente criar um novo componente, o código do componente também deve ser alterado.

Criando um novo componente

Introduza um novo componente e atribua-lhe um código de componente exclusivo ao fazer qualquer uma das seguintes alterações:

• Qualquer alteração que não tenha sido mostrada pelos testes como sendo compatível com versões anteriores do componente. Nesse caso, você também deve alterar o nome ou o local de destino de cada recurso no componente.
• Uma alteração no nome ou local de destino de qualquer arquivo, chave do Registro, atalho ou outro recurso no componente. Nesse caso, você também deve alterar o nome ou o local de destino de cada recurso no componente.
• A adição ou remoção de qualquer arquivo, chave do Registro, atalho ou outro recurso do componente. Nesse caso, você também deve alterar o nome ou o local de destino de cada recurso no componente.
• Recompilando um componente de 32 bits em um componente de 64 bits.

Ao introduzir um novo componente, os autores precisam seguir um destes procedimentos para garantir que o componente não entre em conflito com nenhum componente existente:

• Altere o nome ou o local de destino de qualquer recurso que possa ser instalado com o mesmo nome e local de destino por outro componente.
• Caso contrário, garanta que o novo componente nunca seja instalado na mesma pasta que outro componente que tenha um recurso sob um nome e local comuns. Isso inclui versões localizadas de arquivos com o mesmo nome de arquivo. Para obter mais informações, consulte O que acontece se as regras do componente forem quebradas?.
• Ao alterar o código do componente de um componente existente, altere também o nome ou o local de destino de cada arquivo, chave do Registro, atalho e outro recurso no componente.

Criando uma nova versão de um componente

Uma nova versão de um componente recebe o mesmo código de componente que outro componente existente. Modificar um componente sem alterar o código do componente só é opcional nos seguintes casos:

• As alterações no componente foram comprovadas através de testes de serem retrocompatíveis com todas as versões anteriores do componente.
• O autor pode garantir que a nova versão do componente nunca será instalada em um sistema onde entraria em conflito com versões anteriores do componente ou aplicativos que exigem uma versão anterior. Para obter mais informações, consulte O que acontece se as regras do componente forem quebradas?.

O código do componente de uma nova versão de um componente não deve ser alterado quando isso resultar em dois componentes compartilhando recursos, como valores do Registro, arquivos ou atalhos.