Alterar 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. Pode ser necessário que os autores introduzam novos componentes ou modifiquem componentes existentes. Se a adição, remoção ou modificação de recursos criar de fato um novo componente, o código do componente também deverá ser alterado.

Criar um novo componente

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

• Toda alteração que não tenha sido mostrada pelo teste como 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 um 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 um 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.
• Recompilar um componente de 32 bits em um componente de 64 bits.

Na introdução de um novo componente, os autores precisam fazer um dos seguintes procedimentos para garantir que o componente não entre em conflito com nenhum outro existente:

• Altere o nome ou o local de destino dos recursos que possam ser instalados 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 de outro componente que tem um recurso com um nome e local comuns. Isso inclui versões localizadas de arquivos com o mesmo nome de arquivo. Para obter mais informações, confira O que acontece se as regras de componentes forem desrespeitadas?.
• Ao alterar o código de componente de um outro existente, altere também o nome ou o local de destino de todo arquivo, chave do registro, atalho e dos outros recursos no componente.

Criar uma nova versão de um componente

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

• As alterações no componente foram comprovadas pelo teste como compatíveis com versões anteriores do componente.
• O autor garante que a nova versão do componente nunca será instalada em um sistema em que entraria em conflito com versões anteriores do componente ou em aplicativos que exigem uma versão anterior. Para obter mais informações, confira O que acontece se as regras de componentes forem desrespeitadas?.

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