Partilhar via

Preparar um aplicativo para futuras atualizações principais

  • Artigo

Os criadores de pacotes de instalação devem incluir informações de atualização em seus arquivos .msi para garantir que seu pacote de instalação possa aproveitar a funcionalidade de atualização completa disponível com o Microsoft Windows Installer.

Cada aplicativo ou pacote de aplicativos deve receber uma propriedade UpgradeCode, uma propriedade ProductVersion e uma propriedade ProductLanguage. A propriedade UpgradeCode indica uma família de aplicativos relacionados que consistem em diferentes versões e diferentes versões de idioma do mesmo produto. Para obter mais informações sobre como usar a propriedade UpgradeCode, consulte Usar um UpgradeCode.

Preparar um aplicativo para futuras atualizações principais

  1. Determine um novo valor de código de pacote para o aplicativo. Para obter mais informações sobre códigos de pacote, consulte Códigos de pacote. Insira o novo código do pacote na propriedade Revision Number Summary do Fluxo de Informações de Resumo.
  2. Determine uma nova propriedade ProductCode para o aplicativo. Consulte Alterar o código do produto para obter mais informações. Insira ProductCode e seu valor na tabela Property.
  3. Determine a versão do aplicativo e a propriedade ProductVersion. A propriedade ProductVersion deve aumentar a cada nova versão do aplicativo. Observe que o instalador usa apenas os três primeiros campos da versão do produto. Se você incluir um quarto campo na versão do produto, o instalador ignorará o quarto campo. Insira ProductVersion e seu valor na tabela Property.
  4. Determine o idioma do pacote e a propriedade ProductLanguage. Essa propriedade deve ser um LANGID (identificador de linguagem numérico). Insira ProductLanguage e seu valor na tabela Property. Observe que a ação FindRelatedProducts usa a linguagem retornada por MsiGetProductInfo. Para que FindRelatedProducts funcione corretamente, o autor do pacote deve ter certeza de que a propriedade ProductLanguage está definida na tabela Property como um idioma que também está listado na propriedade Template Summary.
  5. Se você estiver criando um pacote de instalação para a primeira versão do seu produto, use um novo UpgradeCode. Se o pacote for destinado a uma versão mais recente de um produto existente ou for a mesma versão de um produto existente em um idioma diferente, use o mesmo UpgradeCode que o produto existente. Nenhum dos dois produtos com o mesmo ProductVersion e o mesmo ProductLanguage pode ter o mesmo UpgradeCode, a menos que um seja uma pequena atualização do outro.
  6. O UpgradeCode tem o formato de um GUID. Insira o GUID do UpgradeCode na tabela Property.

Para obter mais informações, consulte Impedir que um pacote antigo seja instalado em uma versão mais recente.