Leonardo França » Adobe AIR

Usando a API de atualização do Adobe AIR

Leonardo França — Thu, 18 Aug 2011 21:10:50 +0000

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.

PLAIN TEXT

XML:

 version="1.0" encoding="utf-8"?> 
 xmlns="http://ns.adobe.com/air/framework/update/configuration/1.0"> 
     >http://localhost:81/leonardofranca/air/updates/testeUpdate/updateDescriptor.xml> 
    >1> 
>

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.

PLAIN TEXT

ACTIONSCRIPT3:

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.

PLAIN TEXT

XML:

 version="1.0" encoding="utf-8"?> 
      xmlns="http://ns.adobe.com/air/framework/update/description/2.5"> 
       >0.0.2> 
       >http://localhost:81/leonardofranca/air/updates/testeUpdate/testeUpdate_0.0.2.air> 
       >
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.

PLAIN TEXT

MXML:

"1.0" encoding="utf-8"?>
 xmlns:fx="http://ns.adobe.com/mxml/2009" 
                       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

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

Adobe AIR Device profiles

Leonardo França — Mon, 27 Jun 2011 06:49:49 +0000

No Adobe AIR, você pode configurar os perfis de dispositivos, que são um mecanismo para definir as classes que estarão disponivéis para o dispositivo onde seu aplicativo rodara definindo um conjunto de APIs e recursos, normalmente para uma classe particular de dispositivo. Os perfis disponíveis incluem:

desktop
extendedDesktop
mobileDevice
extendedMobileDevice
tv
extendedTV

Você pode obter mais detalhes sobre cada profile e sobre as classes suportadas no seguinte link:
http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html

Usando Acelerômetro com Adobe AIR for iOS

Leonardo França — Sat, 14 May 2011 01:15:26 +0000

O iPhone possui uma variedade grande de jogos e aplicativos que utilizam o recurso do acelerômetro. Dentre alguns recursos disponiveis que o Adobe AIR pode acessar, o acelerômetro está entre um deles, podendo acessar os dados dos eixos X, Y e Z.

O exemplo utilizado é o mesmo que consta no artigo para uso do acelerômetro com AIR for Android e que foi baseado do exemplo de uso do acelerômetro com Flash Lite 4.0.

Veja o resultado: Usando Acelerômetro com Adobe AIR for iOS

Baixe o fonte
DOWNLOAD

Acessando a camera do celular com Adobe AIR for Android

Leonardo França — Sat, 07 May 2011 04:30:29 +0000

O Adobe AIR for Android pode acessar alguns recursos do hardware dos smartphones. Dentre alguns deles podemos citar o acesso a internet, ler o estado do telefone, o acesso da rede, o acesso da wifi, GPS, sensores etc. O Adobe AIR pode acessar também a camera do dispositivo, sendo que isso pode ser feito de duas maneiras.

O Adobe AIR está disponivel para dispositivos rodando Android a partir da versão 2.2(Froyo)

Temos duas classes para acessar a camera com Adobe AIR for Android:

http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/Camera.html
A primeira maneira de acessar a câmera do celular é usando a classe Camera, clássica e já bastante conhecida de nossos trabalhos em ambiente web e desktop. Antes você pode usar o método Camera.isSupported, e para pegar as câmeras usando Camera.getCamera().

Geralmente essa classe é usada também para enviar o streaming de sua câmera para o servidor Flash Media Server(em conjunto com a classe NetStream) e transmitir para web, desktop ou mobile. Veja um exemplo de uso:

PLAIN TEXT

ACTIONSCRIPT3:

var camera:Camera = Camera.getCamera();
if (camera != null)
{
video = new Video(camera.width * 2, camera.height * 2);
video.attachCamera(camera);
addChild(video);
}
else
{
trace("You need a camera.");
}

No getCamera, se não for passado nenhum parâmetro, acessará a camera principal do dispositivo, você pode acessar uma câmera especifica passando o índice dela como string:

PLAIN TEXT

ACTIONSCRIPT3:

var arrCamera:Array = Camera.names;// todas as câmeras como array
var camera:Camera = Câmera.getCamera(“1”);//acessando a câmera de indece 1

http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/CameraUI.html
CameraUI é uma classe nova exclusiva para o Adobe AIR for Mobile Devices, permitindo que você capture a imagem ou vídeo do aplicativo padrão de câmera do celular. A imagem ou video fica disponivel no objeto MediaEvent. Veja um exemplo de uso:

PLAIN TEXT

ACTIONSCRIPT3:

var deviceCameraApp:CameraUI = new CameraUI();
var imageLoader:Loader; 
 
deviceCameraApp.addEventListener( MediaEvent.COMPLETE, imageCaptured );
                deviceCameraApp.addEventListener( Event.CANCEL, captureCanceled );
                deviceCameraApp.addEventListener( ErrorEvent.ERROR, cameraError );
                deviceCameraApp.launch( MediaType.IMAGE );
 
function imageCaptured( event:MediaEvent ):void
          {
               trace( "Media captured..." );
       
               var imagePromise:MediaPromise = event.data;
       
               if( imagePromise.isAsync )
               {
                trace( "Asynchronous media promise." );
                imageLoader = new Loader();
                imageLoader.contentLoaderInfo.addEventListener( Event.COMPLETE, asyncImageLoaded );
                imageLoader.addEventListener( IOErrorEvent.IO_ERROR, cameraError );
                
                imageLoader.loadFilePromise( imagePromise );
               }
               else
               {
                trace( "Synchronous media promise." );
                imageLoader.loadFilePromise( imagePromise );
                showMedia( imageLoader );
               }
          }
 
function captureCanceled( event:Event ):void
          {
               trace( "Media capture canceled." );
               NativeApplication.nativeApplication.exit();
          }
    
          function asyncImageLoaded( event:Event ):void
          {
               trace( "Media loaded in memory." );
               showMedia( imageLoader );    
          }
    
          function showMedia( loader:Loader ):void
          {
               this.addChild( loader );
          }
      
          function cameraError( error:ErrorEvent ):void
          {
               trace( "Error:" + error.text );
               NativeApplication.nativeApplication.exit();
          }

Um ultimo detalhe para que funcione no smartphone, é necessario setar a permissão para que o aplicativo possa acessar a camera no Android. Isso é feito no xml de configuração do Adobe AIR:

PLAIN TEXT

XML:

As novidades do Adobe AIR 2.6

Leonardo França — Tue, 22 Mar 2011 00:24:52 +0000

A Adobe liberou hoje a nova versão do Adobe AIR para ambiente desktop e mobile(runtime e SDK). O foco dessa versão foi a implementação de melhorias significativas em relação o suporte ao iOS e atingir a paridade de recursos entre Android e iOS. Confira a vasta lista de novidades no blog do Christian Cantrell e no blog do Adobe AIR Team.

Veja esse video do Adobe TV onde Ryan Stewart mostra as novas funcionalidades do AIR for Mobile 2.6, e como possibilita criar aplicativos ricos para dispositivos iOS.