Uma das funcionalidade que mais me foi útil no Adobe AIR, foi a adição de uma API mais bem elaborada para fazer atualização automatica de meus aplicativos. Isso pode ser muito importante porque nem todos os usuários tem tempo(ou vontade) de voltar no site do aplicativo para baixar a última versão.
Isso já é rotina para sistemas operacionais e softwares que usamos no dia-a-dia como o Mozilla Firefox e o Google Chrome(que nem pede permissão para atualizar né senhor Google).
A partir do Adobe AIR 1.5, temos a classe ApplicationUpdater e ApplicationUpdaterUI que tem como objetivo, definir o básico de funcionalidade de atualização para os aplicativos feitos com Adobe AIR
Gerenciar as atualizações pode ser complicado e o AIR update framework possui as API’s necessarias para que você faça isso de maneira prática e funcional. O desenvolvedor pode por exemplo:
- Verificar atualizações por intervalo de tempo ou por requisição do usuário.
- Baixar os arquivos de atualização da web
- Avisar o usuário na primeira execução do software recém-instalado
- Confirmar se o usuário deseja verificar se há atualizações
- Exibir informações sobre a nova versão de atualização para o usuário
- Exibir o status do download ou informação de erro para o usuário
As informações são obtidas a partir de arquivos XML onde você diz qual a última versão do software, as novidades da nova versão etc. Vamos a um exemplo prático, no caso usarei o Flash Builder que já deve ter os arquivos applicationupdater.swc e applicationupdater_ui.swc como referencia na biblioteca.
Começamos pelo xml chamado updateConfig.xml, que “dira” a seu aplicativo onde estão os arquivos para atualização.
-
version=“1.0″ encoding=“utf-8″?>
-
-
-
-
>
Ele deve ser salvo no mesmo diretorio da sua aplicação, junto com os outros arquivos xml e swf. Agora no Flex, instanciaremos a classe ApplicationUpdateUI e setaremos o arquivo xml de configuração para que o Flex possa saber onde está a atualização.
-
var appUpdater:ApplicationUpdaterUI = new ApplicationUpdaterUI();
-
appUpdater.configurationFile = new File(“app:/updateConfig.xml”);
-
appUpdater.initialize();
-
-
//via ActionScript
-
//appUpdater.updateURL = ” http://example.com/updates/update.xml”;
-
//appUpdater.delay = 1;
O arquivo updateDescriptor.xml é onde fica setado a versão em si da atualização do seu aplicativo e onde você pode colocar a descrição das novidades da atualização.
-
version=“1.0″ encoding=“utf-8″?>
-
-
-
-
-
This version has fixes for the following knowns issues:
-
*First issue
-
*Second issue
-
]]>>
-
>
Basicamente é isso, vamos só implementar a chamada para que ao abrir o aplicativo, ele verifique se existe atualização.
-
“1.0″ encoding=“utf-8″?>
-
-
xmlns:s=“library://ns.adobe.com/flex/spark”
-
xmlns:mx=“library://ns.adobe.com/flex/mx” creationComplete=“windowedapplication1_creationCompleteHandler(event)”>
-
-
[CDATA[
-
import air.update.ApplicationUpdaterUI;
-
import air.update.events.UpdateEvent;
-
-
import mx.events.FlexEvent;
-
-
private var appUpdater:ApplicationUpdaterUI;
-
-
protected function windowedapplication1_creationCompleteHandler(event:FlexEvent):void
-
-
appUpdater = new ApplicationUpdaterUI();
-
appUpdater.configurationFile = new File("app:/updateConfig.xml");
-
appUpdater.addEventListener(ErrorEvent.ERROR, onError);
-
appUpdater.addEventListener(UpdateEvent.INITIALIZED, handlerInit);
-
appUpdater.initialize();
-
-
-
//via ActionScript
-
//appUpdater.updateURL = " http://example.com/updates/update.xml";
-
//appUpdater.delay = 1;
-
-
-
-
protected function onError(event:ErrorEvent):void
-
-
trace(event.text);
-
-
-
protected function handlerInit(event:UpdateEvent):void
-
-
appUpdater.checkNow();
-
-
-
]]>
-
>
-
-
-
>
-
>
Criei uma segunda versão do meu aplicativo de teste para demonstração, deveremos ter o seguinte resultado:
Clique para ampliar
Caso o usuário queira verificar se existe alguma atualização do aplicativos, basta clicar no botão “check for upadates. O arquivo atualizado é baixado e instalado.
Clique para ampliar
Clique para ampliar
Clique para ampliar
Referências:
http://help.adobe.com/en_US/air/build/WS9CD40F06-4DD7-4230-B56A-88AA27541A1E.html
http://www.adobe.com/devnet/air/flex/quickstart/articles/update_framework.html
