4D Doc Center : SET UPDATE FOLDER

4D v14.3

SET UPDATE FOLDER


SET UPDATE FOLDER ( viaPasta {; errosDiscretos} )

Parâmetro	Tipo	Descrição
viaPasta	cadeia	Via de acesso da pasta (pacote sob OS X) que contém a aplicação atualizada
errosDiscretos	Booleano	False (por padrão) = mostrar mensagens de erro, True = não reportar eles

Descrição

O comando SET UPDATE FOLDER especifica a pasta que contém a atualização da aplicação 4D fusionada atual. Esta informação se armazena na sessão 4D até que se chama o método RESTART 4D. Se sair da aplicação manualmente, esta informação não se conserva.

Este comando está destinado a ser utilizado em um processo de atualização automática de uma aplicação fundida (servidor ou autônomo). Para mais informação, consulte o capítulo Finalizar e distribuir aplicativos no Manual de Desenho.

Nota: Este comando só funciona com 4D Server ou com uma aplicação autônoma fundida com 4D Volume Desktop.

No parâmetro viaPasta, passe a via de acesso completa da pasta da nova versão da aplicação fundida (pasta que contém a aplicação my4DApp.exe sob Windows ou o pacote my4DApp.app sob OS X), criado pelo gerador de aplicações de 4D. A nova versão deve ter sido gerada pelo gerador de aplicações de 4D v14. Em particular, deve conter uma versão atualizada da ferramenta "updater" incluída em 4D e que se utiliza para administrar as atualizações remota.

Nota: Lhe recomendamos que utilize os mesmos nomes da versão original para os arquivos da nova versão da aplicação, já que a pasta da aplicação se substitui durante a atualização. Se utilizar nomes diferentes para estes arquivos, os atalhos e/ou vias armazenadas já não funcionarão mais.

Se os parámetros são válidos, a atualização fica "em espera" na sessão até que se chame o comando RESTART 4D. Foi executada várias vezes SET UPDATE FOLDER antes de chamar a [RESTART 4D, se leva em conta a última chamada válida.

Pode passar uma cadeia vazia ("" ) no parâmetro viaPasta para reinicializar a informação de atualização para a sessão atual.

O parâmetro opcional errosDiscretos especifica como se reportam os erros pela ferramenta "updater":

Se passar False ou se omitir este parâmetro, os erros se registram no histórico de atualização e se mostram em uma caixa de diálogo de alerta.
Se passar True, os erros só se registram no histórico de atualização.

Exceção: Se a ferramenta "updater" não pode criar o arquivo de histórico, se mostra uma caixa de diálogo de alerta, independentemente do valor do parâmetro errosDiscretos. Para mais informação, consulte a descrição do comando Get last update log path.

Se o comando se executa corretamente, a variável sistema OK toma o valor 1, caso contrário, toma o valor 0. Pode interceptar os erros gerados pelo comando utilizando um método instalado utilizando o comando ON ERR CALL.

Exemplo

Você criou uma pasta "MyUpdates" em seu disco, na qual localizou uma nova versão da aplicação "MyApp". Você não deseja mostrar os erros. Para preparar a atualização, escreve:

  // Sintaxe Windows

 SET UPDATE FOLDER("C:\\MyUpdates"+Folder separator+"MyApp";True)

 

  // Sintaxe OS X

 SET UPDATE FOLDER("MacHD:MyUpdates"+Folder separator+"MyApp.app";True)