Aplicativos BlackBerry HTML5 WebWorks para o tablet BlackBerry PlayBook Módulo 3 - Desenvolvendo seu primeiro aplicativo para o tablet BlackBerry

Aplicativos BlackBerry HTML5 WebWorks para o tablet BlackBerry PlayBook Módulo 3 - Desenvolvendo seu primeiro aplicativo para o tablet BlackBerry PlayBook

2 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

2012 Research In Motion Limited. Todos os direitos reservados. BlackBerry, RIM, Research In Motion, SurePress, SureType e marcas comerciais, nomes e logotipos relacionados são propriedade da Research In Motion Limited e estão registrados e/ou são usados nos E.U.A. e em vários países do mundo. Ripple é uma marca comercial da tinyhippos, Inc.; JavaScript é uma marca comercial da Oracle America, Inc.; Dropbox é uma marca comercial da Dropbox, Inc. Corporation.; WinZip é uma marca comercial da WinZip International LLC.; VMware é uma marca comercial da VMware, Inc.; Windows é uma marca comercial da Microsoft Corporation.; Mac OS é uma marca comercial da Apple Inc. Google Chrome é uma marca comercial da Google Inc.; Mozilla and Firefox são marcas comerciais da Mozilla Foundation.; Web Inspector é uma marca comercial da Wintriss Engineering Corporation. Todas as outras marcas comerciais pertencem a seus respectivos proprietários. Esta documentação, incluindo toda a documentação incorporada por referência, como a fornecida ou disponível através de hiperlink, é oferecida ou disponibilizada "NA FORMA EM QUE SE ENCONTRA" e "CONFORME A DISPONIBILIDADE", sem condições, endossos, responsabilidades, declarações ou garantias de qualquer espécie pela Research In Motion Limited e suas empresas afiliadas ("RIM"), e a RIM não assume nenhuma responsabilidade por erros tipográficos, técnicos ou de outra natureza encontrados neste documento, nem por eventuais omissões. Esta documentação pode usar termos genéricos ao descrever alguns aspectos de tecnologia da RIM com o objetivo de proteger informações confidenciais e de propriedade da RIM e/ou segredos comerciais. A RIM reserva-se o direito de alterar periodicamente as informações contidas nesta documentação e não se compromete a fornecer, seja regularmente ou de qualquer outra forma, tais alterações, atualizações, aprimoramentos ou outras inclusões à mesma. Esta documentação pode conter referências a fontes de informação, hardware ou software, produtos ou serviços de terceiros, incluindo componentes e conteúdo protegidos por direitos autorais e/ou sites de terceiros (coletivamente chamados de Produtos e Serviços de Terceiros ). A RIM não controla nem se responsabiliza por quaisquer Produtos e Serviços de Terceiros, incluindo, sem limitações, conteúdo, precisão, conformidade com leis de direitos autorais, desempenho, compatibilidade, confiabilidade, legalidade, decoro, links ou qualquer outro aspecto a eles relacionado. A inclusão de uma referência a Produtos e Serviços de Terceiros nesta documentação não implica o endosso da RIM quanto a esses produtos e serviços, nem aos terceiros que os fornecem. SALVO NA MEDIDA EM QUE FOR ESPECIFICAMENTE PROIBIDO PELA LEGISLAÇÃO APLICÁVEL NA SUA JURISDIÇÃO, TODAS AS CONDIÇÕES, ENDOSSOS, RESPONSABILIDADES, REPRESENTAÇÕES OU GARANTIAS DE QUALQUER ESPÉCIE, EXPRESSAS OU IMPLÍCITAS, INCLUINDO, SEM LIMITAÇÕES, QUAISQUER CONDIÇÕES, ENDOSSOS, RESPONSABILIDADES, REPRESENTAÇÕES OU GARANTIAS DE DURABILIDADE, ADEQUAÇÃO A UMA FINALIDADE OU USO ESPECÍFICOS, COMERCIALIZAÇÃO, QUALIDADE DE COMERCIALIZAÇÃO, NÃO-VIOLAÇÃO, QUALIDADE SATISFATÓRIA OU PROPRIEDADE, OU QUE RESULTEM DE UM ESTATUTO OU COSTUME, OU DE NEGOCIAÇÃO OU USO COMERCIAL, OU RELACIONADAS À DOCUMENTAÇÃO OU AO SEU USO, OU AO DESEMPENHO OU À FALTA DE DESEMPENHO DE QUALQUER SOFTWARE, HARDWARE, SERVIÇO OU DE QUAISQUER PRODUTOS OU SERVIÇOS DE TERCEIROS CITADOS NESTE DOCUMENTO, FICAM AQUI EXCLUÍDAS. VOCÊ TAMBÉM PODERÁ TER OUTROS DIREITOS DEPENDENDO DO SEU ESTADO OU PROVÍNCIA. ALGUMAS JURISDIÇÕES NÃO PERMITEM LIMITAÇÕES NEM EXCLUSÕES DE GARANTIAS E CONDIÇÕES IMPLÍCITAS. NA EXTENSÃO PERMITIDA PELA LEI, QUAISQUER GARANTIAS OU CONDIÇÕES IMPLÍCITAS RELACIONADAS À DOCUMENTAÇÃO NA MEDIDA EM QUE NÃO PUDEREM SER EXCLUÍDAS CONFORME ACIMA ESTABELECIDO, MAS PUDEREM SER LIMITADAS, FICAM AQUI LIMITADAS A 90 (NOVENTA) DIAS A PARTIR DA DATA DA AQUISIÇÃO DA DOCUMENTAÇÃO OU DO ITEM QUE SEJA OBJETO DA REIVINDICAÇÃO. NA MÁXIMA EXTENSÃO PERMITIDA PELA LEGISLAÇÃO APLICÁVEL NA SUA JURISDIÇÃO, EM NENHUMA CIRCUNSTÂNCIA A RIM SE RESPONSABILIZARÁ POR QUALQUER TIPO DE DANO RELACIONADO A ESTA DOCUMENTAÇÃO OU AO SEU USO, OU AO DESEMPENHO OU FALTA DE DESEMPENHO DE QUALQUER SOFTWARE, HARDWARE, SERVIÇO OU QUAISQUER PRODUTOS E SERVIÇOS DE TERCEIROS CITADOS NESTE DOCUMENTO, INCLUINDO, SEM LIMITAÇÕES, QUALQUER UM DESTES DANOS: DANOS DIRETOS, RESULTANTES, EXEMPLARES, INCIDENTAIS, INDIRETOS, ESPECIAIS, PUNITIVOS OU AGRAVADOS, DANOS POR LUCROS CESSANTES OU PERDA DE RECEITA, NÃO CUMPRIMENTO DE METAS COMERCIAIS, INTERRUPÇÃO DOS NEGÓCIOS, PERDA DE INFORMAÇÕES COMERCIAIS, PERDA DE OPORTUNIDADES COMERCIAIS, OU PERDA DE DADOS OU DADOS CORROMPIDOS, PROBLEMAS DE TRANSMISSÃO OU RECEBIMENTO DE DADOS, PROBLEMAS ASSOCIADOS A APLICATIVOS USADOS JUNTO COM PRODUTOS OU SERVIÇOS DA RIM, CUSTOS DECORRENTES DE TEMPO DE INATIVIDADE, PERDA DE USO DE PRODUTOS OU SERVIÇOS DA RIM OU DE QUALQUER PARTE DELES OU DE QUAISQUER SERVIÇOS DE TRANSMISSÃO SEM FIO, CUSTO DE MERCADORIAS DE REPOSIÇÃO, CUSTOS DE SUPORTE, EQUIPAMENTOS OU SERVIÇOS, CUSTO DO CAPITAL OU OUTRAS PERDAS FINANCEIRAS SEMELHANTES, SEJAM TAIS DANOS PREVISÍVEIS OU IMPREVISÍVEIS, E MESMO QUE A RIM TENHA SIDO ALERTADA SOBRE A POSSIBILIDADE DE TAIS DANOS. NA MÁXIMA EXTENSÃO PERMITIDA PELA LEGISLAÇÃO APLICÁVEL NA SUA JURISDIÇÃO, A RIM NÃO TERÁ QUALQUER OUTRO TIPO DE OBRIGAÇÃO, DEVER OU RESPONSABILIDADE, SEJA CONTRATUAL, EXTRACONTRATUAL OU DE OUTRA FORMA RELACIONADA A VOCÊ, INCLUINDO QUALQUER RESPONSABILIDADE POR NEGLIGÊNCIA OU RESPONSABILIDADE OBJETIVA. Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 3

AS LIMITAÇÕES, EXCLUSÕES E ISENÇÕES DE RESPONSABILIDADE AQUI ESTABELECIDAS SERÃO APLICADAS: (A) INDEPENDENTEMENTE DA NATUREZA DA FORMA DE AÇÃO, DEMANDA OU AÇÃO REALIZADA POR VOCÊ INCLUINDO, SEM LIMITAÇÕES, VIOLAÇÃO DE CONTRATO, NEGLIGÊNCIA, RESPONSABILIDADE EXTRACONTRATUAL OU OBJETIVA OU QUALQUER OUTRA TEORIA LEGAL E PERMANECERÃO EM VIGOR MESMO NO CASO DE VIOLAÇÕES FUNDAMENTAIS OU DO NÃO CUMPRIMENTO DO PRINCIPAL OBJETIVO DESTE CONTRATO OU DE QUAISQUER RECURSOS CONTIDOS NESTE DOCUMENTO; E (B) À RIM E SUAS AFILIADAS, SEUS SUCESSORES, PROCURADORES, AGENTES, FORNECEDORES (INCLUINDO PROVEDORES DE SERVIÇOS DE TRANSMISSÃO SEM FIO), DISTRIBUIDORES AUTORIZADOS DA RIM (INCLUINDO TAMBÉM PROVEDORES DE SERVIÇOS DE TRANSMISSÃO SEM FIO) E SEUS RESPECTIVOS DIRETORES, FUNCIONÁRIOS E PRESTADORES DE SERVIÇO INDEPENDENTES. ALÉM DAS LIMITAÇÕES E EXCLUSÕES ACIMA ESTABELECIDAS, EM NENHUMA CIRCUNSTÂNCIA OS DIRETORES, FUNCIONÁRIOS, AGENTES, DISTRIBUIDORES, FORNECEDORES, PRESTADORES DE SERVIÇO INDEPENDENTES DA RIM OU DE QUALQUER UMA DE SUAS AFILIADAS TERÃO QUALQUER TIPO DE RESPONSABILIDADE RESULTANTE DA DOCUMENTAÇÃO OU A ELA RELACIONADA. Antes de assinar, instalar ou usar quaisquer Produtos e Serviços de Terceiros é sua responsabilidade garantir que o provedor de serviços de transmissão sem fio concorde em oferecer suporte a todos os recursos. Alguns provedores de serviços de transmissão sem fio talvez não ofereçam a funcionalidade de navegação na Internet com uma assinatura do BlackBerry Internet Service. Consulte sua operadora para obter informações sobre disponibilidade, recursos e planos de roaming e de serviço. A instalação ou uso de Produtos e Serviços de Terceiros com os produtos e serviços da RIM podem exigir uma ou mais licenças de patente, marca comercial ou direitos autorais ou outras licenças a fim de evitar a infração ou violação dos direitos de terceiros. É sua total responsabilidade determinar se Produtos e Serviços de Terceiros devem ser utilizados e se é necessário obter licenças de terceiros para tanto. Em caso afirmativo, você será o responsável pela aquisição das mesmas. Você não deverá instalar ou usar Produtos e Serviços de Terceiros até que todas as licenças necessárias tenham sido obtidas. Quaisquer Produtos e Serviços de Terceiros fornecidos com produtos e serviços da RIM são fornecidos como uma conveniência para você e NO ESTADO EM QUE SE ENCONTRAM, sem condições, endossos, responsabilidades, declarações ou garantias de qualquer espécie, explícitas ou implícitas, por parte da RIM, e a RIM não assume qualquer tipo de responsabilidade em relação a eles. O uso que você faz dos Produtos e Serviços de Terceiros será regido e estará sujeito à sua aceitação dos termos das licenças individuais e de outros contratos aplicáveis com terceiros, a menos que sejam expressamente incluídos em uma licença ou outro contrato com a RIM. Certos recursos descritos nesta documentação exigem uma versão mínima do software BlackBerry Enterprise Server, do BlackBerry Desktop Software e/ou do BlackBerry Device Software e podem exigir desenvolvimento adicional ou Produtos e Serviços de Terceiros para fornecer acesso a aplicativos corporativos. Este produto inclui software desenvolvido pela Apache Software Foundation (http://www.apache.org/) e/ou licenciado de acordo com o documento Apache License, versão 2.0 (http://www.apache.org/licenses/). Para obter mais informações, consulte o arquivo NOTICE.txt que acompanha o software. A menos que exigido pelas leis aplicáveis ou estabelecido em acordo por escrito, o software é distribuído sob a licença NA FORMA EM QUE SE ENCONTRA, SEM GARANTIAS OU CONDIÇÕES DE NENHUMA ESPÉCIE, sejam elas expressas ou implícitas. Consulte a licença para conhecer as limitações e permissões específicas ao seu idioma sob os termos da mesma. Os termos de uso de qualquer produto ou serviço da RIM são estipulados em uma licença individual ou em outro contrato com a RIM aplicável a eles. NENHUM TERMO DESTA DOCUMENTAÇÃO DESTINA-SE A SUBSTITUIR CONTRATOS OU GARANTIAS EXPRESSAS POR ESCRITO FORNECIDAS PELA RIM PARA PARTES DE QUALQUER PRODUTO OU SERVIÇO DA RIM QUE NÃO SEJA ESTA DOCUMENTAÇÃO. 4 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Sobre este manual de trabalho Este material foi elaborado pressupondo que os participantes atenderam a todos os requisitos antes de tentar os exercícios. Para evitar um impacto negativo na qualidade da experiência de aprendizagem, a RIM recomenda que os alunos atendam aos pré-requisitos. Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 5

Sumário Sobre este manual de trabalho... 5 Visão geral... 8 Objetivos... 8 Pré-requisitos recomendados... 8 Requisitos de software... 8 Criando um arquivo.html... 10 Criando um ícone para o aplicativo... 11 Criando o documento de configuração "config.xml"... 12 Compilando um aplicativo HTML5 WebWorks... 14 Criando um arquivo comprimido... 14 Figura 3: Pasta de saída... 15 Empacotando um aplicativo para a implantação no simulador... 16 Compilando e empacotando com o emulador Ripple... 19 Acessando arquivos de um sistema de arquivos local usando o Ripple... 19 Acessando um arquivo de projeto a partir de um servidor web remoto usando o Ripple. 19 Opções de empacotamento do emulador Ripple... 22 Configurações opcionais de empacotamento no emulador Ripple... 24 Empacotando um aplicativo usando o emulador Ripple... 24 Implantando o aplicativo no simulador do Tablet usando o Prompt de comando... 26 Implantando o aplicativo no simulador do Tablet usando o emulador Ripple... 31 Resumo e mais aprendizagem... 33 Resumo... 33 Mais aprendizagem... 33 Recursos adicionais... 33 6 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 7

Visão geral Objetivos Neste módulo, o aluno aprenderá a: Criar um arquivo "index.html" para um aplicativo Aproveitar um gráfico existente para um ícone do aplicativo Criar um arquivo "config.xml" para um aplicativo Empacotar os arquivos do aplicativo usando o BlackBerry WebWorks Packager em um arquivo ".bar" usando o prompt de comando Acessar um arquivo de projeto a partir de um servidor Web remoto no emulador Ripple para visualização do aplicativo Empacotar um aplicativo usando o emulador Ripple Implantar o aplicativo no simulador do BlackBerry Playbook usando o prompt de comando Empacotar e iniciar o aplicativo no simulador do PlayBook BlackBerry usando o emulador Ripple Pré requisitos recomendados Para este módulo, os pré-requisitos recomendados de habilidades e áreas de conhecimento são: Conhecimento dos padrões web, como HTML, CSS e JavaScript Experiência em usar a ferramenta Prompt de comando do Windows Experiência em usar um aplicativo para criar um arquivo.zip Requisitos de software Para completar este módulo, é necessário o seguinte: Um editor de HTML (como o Notepad) O arquivo "icon.png" da pasta de códigos de exemplo Os arquivos "index.html" e "config.xml" da pasta de códigos de exemplo Um aplicativo que possa criar arquivos.zip como o WinZip Instalação do BlackBerry WebWorks SDK Instalação do simulador do BlackBerry PlayBook (usando VMWare ) Instalação do software emulador Ripple Acesso a um servidor web remoto (como o Dropbox ) O arquivo "icon.png" é uma imagem gráfica que pode ser usada como ícone do aplicativo que os alunos irão criar. Esse ícone será exibido na tela inicial do BlackBerry PlayBook, no simulador do BlackBerry PlayBook. 8 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Se o WinZip não estiver instalado no computador host local, um aplicativo de código aberto, como o 7-zip, pode ser baixado e usado. O 7-zip pode ser baixado de http://www.7-zip.org/ Para testar o aplicativo, o simulador do BlackBerry PlayBook deve ser instalado antes deste módulo. Instruções de instalação junto com os requisitos recomendados de hardware e software estão incluídos no Módulo 2. Da mesma forma, instruções para a instalação do software emulador Ripple também podem ser encontradas no Módulo 2. Uma conta Dropbox pode ser criada gratuitamente para este módulo em www.dropbox.com Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 9

Criando um arquivo.html Para começar a criar o aplicativo "Hello World", abra um editor de texto como o Notepad para criar um novo arquivo. Esse arquivo irá conter o conteúdo do aplicativo. Esse arquivo será salvo como um arquivo.html. No novo arquivo, adicione o código HTML: <!DOCTYPE html> <html> <head> <style type="text/css"> body { font-size: 5em; } </style> </head> <body> <p> Hello World </p> </body> </html> Depois de adicionar o código HTML como conteúdo desse arquivo, salve o arquivo como "index.html". 10 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Criando um ícone para o aplicativo Para tornar um aplicativo acessível aos usuários, ele deve ter um ícone que os usuários possam clicar na tela inicial do tablet para iniciar o aplicativo. Os ícones podem aproveitar um gráfico existente ou serem personalizados usando um software de edição de gráficos (ex: Adobe Photoshop), reutilizar imagens de seu próprio site ou de um banco de dados de imagens on-line sem direitos autorais (ex: istockphoto.com). Outra opção é criar seu próprio ícone usando um aplicativo como o Icon Maker para BlackBerry PlayBook Se estiver criando ou aproveitando um gráfico existente para um ícone, as dimensões e os formatos de arquivo recomendados são: Dimensões recomendadas: 86 x 86 pixels Formato de arquivo recomendado: PNG Para este módulo, vamos utilizar o gráfico "icon.png" que está incluído na pasta de códigos de exemplo com este módulo. Figura 1: Ícone Hello World "icon.png" Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 11

Criando o documento de configuração "config.xml" O documento de configuração do BlackBerry HTML5 WebWorks é um arquivo.xml que contém os elementos para definir o namespace do aplicativo BlackBerry HTML5 WebWorks, o nome do aplicativo, as permissões do aplicativo, a página inicial e os ícones de uso do aplicativo. Ele também contém os elementos para definir informações como autor, endereço de e-mail e outras configurações. O documento de configuração contém o elemento widget em sua raiz. O elemento widget fornece um contêiner para todos os outros elementos. O documento de configuração é um documento XML baseado em especificações W3C. O arquivo "config.xml" contém elementos para definir: Namespace do aplicativo e nome do aplicativo Permissões de aplicativo Página inicial Ícone a ser usado para o aplicativo Nome do desenvolvedor do aplicativo Outras definições de configuração (como prioridade de transporte de rede, opções de inicialização etc.) O documento config.xml também define configurações adicionais, como prioridade de transporte de rede, opções de inicialização, informações de licença, etc. Uma lista completa pode ser encontrada em Blog do desenvolvedor do BlackBerry. Para criar o documento "config.xml", abra um editor de texto como o Notepad e crie um novo arquivo. Quando o novo arquivo for aberto, adicione o seguinte conteúdo XML ao arquivo: <?xml version="1.0" encoding="utf-8"?> <widget xmlns="http://www.w3.org/ns/widgets" xmlns :rim="http://www.blackberry.com/ns/widgets" version="1.0.0.0"> <name>hello World</name> <icon src="icon.png"/> <content src="index.html"/> </widget> 12 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Ao criar um arquivo "config.xml" para um aplicativo HTML5 WebWorks, você deve atribuir o namespace do aplicativo BlackBerry HTML5 WebWorks ao elemento widget. Se o namespace estiver faltando, o arquivo comprimido do aplicativo não será válido. O namespace do aplicativo é http://www.w3.org/ns/widgets O namespace de extensões do BlackBerry HTML5 WebWorks não é opcional. O namespace para extensões de aplicativo específicas do BlackBerry é xmlns:rim O arquivo "config.xml" define as características visuais do aplicativo. Por exemplo, no código XML a seguir: <?xml version="1.0" encoding="utf-8"?> <widget xmlns="http://www.w3.org/ns/widgets" xmlns :rim="http://www.blackberry.com/ns/widget s" version="1.0.0.0"> <name>hello World</name> <icon src="icon.png"/> As tags destacadas em vermelho indicam as características visuais do aplicativo: o nome do aplicativo (Hello World) e seu gráfico (o gráfico "icon.png"). Figura 2: Ícone Hello World Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 13

Compilando um aplicativo HTML5 WebWorks Depois de criar um index.hml, config.xml e um ícone, um aplicativo básico HTML5 WebWorks pode ser criado e carregado no simulador do BlackBerry PlayBook. Antes de carregar o aplicativo no simulador do BlackBerry PlayBook ou no Tablet, os arquivos devem ser compilados em um arquivo ".bar". Ao compilar um aplicativo BlackBerry WebWorks, o BlackBerry WebWorks Packager executa as seguintes ações: Valida o conteúdo dos arquivos comprimidos do BlackBerry HTML5 WebWorks Cria a pasta de destino de saída e limpa todos os arquivos antigos (se necessário) Cria a pasta de destino de origem e limpa todos os arquivos antigos (se necessário) Criando um arquivo comprimido Um arquivo comprimido do BlackBerry HTML5 WebWorks é um arquivo ".zip" que você pode criar com qualquer ferramenta de arquivamento de zip, que é depois compilado usando a ferramenta de linha de comando do BlackBerry WebWorks Packager (bbwp) para criar o aplicativo. O arquivo comprimido do aplicativo contém os seguintes recursos: documento de configuração (arquivo ".xml") página inicial (".html" ou outros arquivos) ícones de aplicativo (arquivo".png") outros recursos e objetos referenciados no aplicativo O nome do arquivo.zip não deve ter mais de 10 caracteres (sem incluir a extensão.zip). Se você enviou previamente o aplicativo para o BlackBerry App World, não poderá mudar o nome do arquivo.zip em versões posteriores; ele deverá permanecer o mesmo. Se o nome do arquivo.zip for alterado, não será possível atualizar o aplicativo. Você não deve colocar nenhum de seus arquivos de origem ou arquivo comprimido do aplicativo na pasta de instalação do BlackBerry WebWorks Packager. Ao compilar um aplicativo usando a ferramenta de linha de comando "bbwp", a pasta de saída padrão criada é "bin", que tentará substituir o diretório "bin" do BlackBerry WebWorks SDK que contém arquivos importantes. 14 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Para criar o arquivo archive.zip, execute as seguintes etapas: 1. Crie uma pasta para armazenar os arquivos C:\myapp Salve "config.xml", "index.html" e "icon.png" nesta pasta 2. Salve "index.html", "config.xml" "icon.png" com um arquivo.zip Renomeie o arquivo.zip como "hw.zip" 3. Crie uma segunda pasta no diretório "C:\myapp"denominada "saída" C:\myapp\saída Você precisará da pasta "C:\myapp\saída" quando o aplicativo estiver compilado. Quando o aplicativo é compilado usando o BlackBerry WebWorks Packager, um arquivo ". bar" é fornecido e armazenado na pasta de "saída". Esse arquivo ".bar" será implantado no Tablet. Figura 3: Pasta de saída Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 15

Empacotando um aplicativo para a implantação no simulador Depois que o arquivo é criado, o aplicativo HTML5 WebWorks pode ser compilado e empacotado para implantação. Para implantar o aplicativo no simulador do Tablet BlackBerry, ele deve ser empacotado como um arquivo ".bar". O primeiro método que pode ser usado para empacotar um aplicativo HTML5 WebWorks é usar a ferramenta Prompt de linha de comando do Windows e o BlackBerry WebWorks Packager (bbwp.exe). Para acessar o Prompt de linha de comando em um computador com sistema operacional Windows, clique no menu "Iniciar" Executar cmd (pressione a tecla "Enter") Para usar o Prompt de linha de comando, digite: cd C:\Arquivos de programa\research In Motion\BlackBerry HTML5 WebWorks SDK para TabletOS 2.2.0.5\bbwp Compile o aplicativo usando a seguinte sintaxe: bbwp C:\myapp\hw.zip o C:\myapp\saída Figura 4: Empacotando um aplicativo para implantação 16 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Se a compilação foi bem-sucedida, um arquivo ".bar" será criado na pasta "C:\myapp\saída" se o valor do parâmetro "-o" for especificado. Se nenhum parâmetro " o" for especificado, o arquivo ".bar" será criado em uma subpasta denominada "bin", localizada na pasta "C:\myapp". Figura 5: Empacotando um aplicativo para implantação Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 17

Figura 6: Arquivo ".bar" criado em diretório especificado Se o aplicativo foi compilado corretamente, um arquivo ".bar" será criado no diretório "C:\myapp\saída" como pode ser visto no diagrama acima. 18 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Compilando e empacotando com o emulador Ripple Um segundo método para empacotamento e implantação de um aplicativo é usar o emulador Ripple. Depois que os arquivos de um aplicativo são desenvolvidos (o ".htm", "config.xml", "icon.jpg" e outros arquivos relacionados), eles podem ser empacotados e compilados usando o emulador Ripple para implantação no simulador do PlayBook. Acessando arquivos de um sistema de arquivos local usando o Ripple Se os arquivos do aplicativo forem armazenados no computador local de um desenvolvedor, eles poderão ser acessados se um servidor web remoto não estiver disponível. A partir do emulador Ripple, você pode abrir arquivos diretamente do sistema de arquivos local no seu computador executando as seguintes etapas: 1. Copie a pasta do projeto e todo o seu conteúdo na pasta RippleSites. Se essa pasta não existir, você deverá criá-la em um dos seguintes locais: Windows XP: C:\Documentos e Configurações\<Nome_usuário>\RippleSites Windows 7: C:\Usuários\<Nome_usuário>\RippleSites Mac OS: /Usuários/<Nome_usuário>/RippleSites 2. No Ripple, na barra de endereço, digite http://localhost:9900/ seguido pela pasta do projeto e uma página de destino. Por exemplo: http://localhost:9900/helloworld/index.html Mais informações sobre como acessar os arquivos usando Ripple se um servidor web remoto não estiver disponível pode ser acessado em Blog do desenvolvedor do BlackBerry. Acessando um arquivo de projeto a partir de um servidor web remoto usando o Ripple Para testar um aplicativo HTML5 WebWorkss no emulador Ripple instalado no servidor web remoto (como Drop Box), os arquivos devem ser armazenados em uma pasta pública. Qualquer um dos arquivos Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 19

estará acessível ao público. Para usar um serviço como o Drop Box, coloque o index.html, config.xml e icon.png e quaisquer outros arquivos em uma pasta pública. Se estiver usando o Drop Box, salve os arquivos "index.html", "config.xml" e "icon.png" em uma pasta pública na conta do Drop Box. Depois de salvar para a pasta Pública, siga as seguintes etapas: Abra a conta Dropbox em um navegador web (como o Google Chrome, Mozilla Firefox etc.) Navegue até a pasta Pública, clique com o botão direito do mouse no arquivo de índice e selecione "Copiar link público" Figura 7: Acessando um arquivo de projeto do Dropbox 20 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Selecione "Copiar para a área de transferência" Cole este link na barra de endereços do Ripple Figura 8: Copiar para a área de transferência Figura 9: Barra de endereços do Ripple A mensagem Hello World aparecerá na tela do PlayBook no emulador Ripple Figura 10: Mensagem Hello World no emulador Ripple Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 21

Opções de empacotamento do emulador Ripple O emulador Ripple pode ser usado para empacotar e compilar arquivos para um aplicativo HTML5 WebWorks. Antes de começar a compilar um aplicativo usando o emulador Ripple, você deve estar familiarizado com algumas opções de empacotamento disponíveis. Para obter informações sobre como baixar e instalar o software emulador Ripple, consulte o Módulo 2. Para usar qualquer uma dessas opções de empacotamento, as configurações devem ser definidas para a plataforma a ser usada no emulador Ripple (por exemplo, WebWorks-TabletOS). Para definir as configurações, clique na opção de menu "Plataformas" e selecione "WebWorks-Tablet OS". Figura 11: Selecionando a opção de empacotamento Para acessar as opções de empacotamento no emulador Ripple, clique no ícone no canto direito superior da tela. As seguintes opções estão disponíveis para empacotamento: de ferramenta Figura 12: Opções de empacotamento Empacotar - Esta opção cria e empacota o aplicativo. Para aplicativos do tablet BlackBerry, esta opção cria os arquivos.zip e.bar para o aplicativo Empacotar e assinar - Esta opção cria, empacota e assina o aplicativo. Para aplicativos do tablet BlackBerry, esta opção cria os arquivos.zip e arquivos.bar assinados para o aplicativo Empacotar e iniciar -Esta opção cria, empacota e inicia o aplicativo no simulador especificado. Para aplicativos do tablet BlackBerry, esta opção cria os arquivos.zip e.bar para o aplicativo Para empacotar um aplicativo no emulador Ripple: 22 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Selecione o ícone de ferramenta localizado no canto superior direito do emulador Ripple e selecione Configurações Na caixa de diálogo "Pacote", você será solicitado a inserir a localização do BlackBerry HTML5 WebWorks SDK e a localização dos arquivos do aplicativo Hello World. Para obter informações sobre como baixar e instalar o BlackBerry HTML5 WebWorks SDK, consulte o Módulo 2. Caminho do SDK - O caminho onde o BlackBerry WebWorks SDK está instalado. Essas informações são necessárias para empacotar o aplicativo. A seguir, os caminhos padrão do SDK Windows XP: C:\Arquivos de programas\research In Motion\BlackBerry WebWorks SDK para TabletOS <versão nº> Windows 7: C:\Arquivos de programas(x86)\research In Motion\BlackBerry WebWorks SDK para TabletOS <versão nº> Mac OS: /Desenvolvedor/SDKs/Research In Motion/BlackBerry WebWorks SDK para TabletOS <versão nº> Raiz do projeto - A localização do seu projeto (onde os arquivos index.html, config.xml e icon.png são salvos). Esta definição é necessária para empacotar o aplicativo. Exemplo: C:\myapp\hw Nome do arquivo comprimido - O nome do arquivo comprimido será (por exemplo, "hw" ou "HelloWorld"). Esta definição é necessária para empacotar o aplicativo. Pasta de saída - O local onde os arquivos de saída irão residir. Não pode ser o mesmo local da raiz do projeto. Esta informação é necessária para empacotar o aplicativo. Exemplo: C:\myapp\saída Figura 13: Exemplo C:\myapp\saída Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 23

Configurações opcionais de empacotamento no emulador Ripple Existem configurações de empacotamento adicionais no emulador Ripple. Essas opções adicionais incluem: Habilitar Web Inspector - Esta configuração especifica se o web inspector remoto deve ser habilitado ou desabilitado para depurar e perfilar o aplicativo em um aparelho ativo Observação: deve ser desativado no empacotamento do aplicativo para distribuição para a loja online do BlackBerry App World Condicional: esta configuração só será necessária se um desenvolvedor estiver testando o aplicativo com o web inspector remoto Senha CSK - A senha especificada para o armazenamento de chaves de um desenvolvedor (quando um desenvolvedor é registrado com a autoridade de assinatura RIM para chaves de assinatura de código Condicional: esta configuração só será necessária se o aplicativo for assinado Senha P12 - A senha que um desenvolvedor especifica ao criar seu certificado de desenvolvedor. Caso contrário, será a senha do armazenamento de chaves Condicional: esta configuração só será necessária se o aplicativo for assinado Número do pacote - O número de pacote para o aplicativo do desenvolvedor (por exemplo, 1.0.0.x, onde x é o número do pacote). Após a assinatura bem-sucedida do aplicativo, esse número aumenta automaticamente em 1. Condicional: esta configuração só será necessária se o aplicativo for assinado IP do PlayBook - O endereço IP do simulador do Tablet BlackBerry do desenvolvedor. Condicional: Esta configuração só será necessária se o aplicativo for iniciado em um simulador Senha do PlayBook - A senha do simulator do Tablet BlackBerry do desenvolvedor Condicional: Esta configuração só será necessária se o aplicativo for iniciado em um simulador Empacotando um aplicativo usando o emulador Ripple Antes de começar a empacotar seu aplicativo usando o emulador Ripple, verifique se as definições de "Compilação" estão configuradas. Da mesma forma, verifique se o arquivo do documento de configuração (config.xml) está armazenado na raiz do projeto. Para empacotar seu aplicativo: 24 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Selecione o ícone de ferramenta localizado no canto superior direito do emulador Ripple Selecione Empacotar O emulador Ripple compila o aplicativo Se a compilação e o empacotamento forem concluídos com êxito, a mensagem "Compilação bem-sucedida!" será exibida e o arquivo ". bar" será armazenado na Pasta de saída Figura 14: Compilação bem-sucedida Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 25

Implantando o aplicativo no simulador do Tablet usando o Prompt de comando Depois de empacotar e compilar com sucesso seu aplicativo é recomendável testá-lo no simulador do BlackBerry PlayBook antes de implantá-lo no Tablet. O simulador do Tablet BlackBerry permite aos desenvolvedores executar e testar um aplicativo sem ter acesso ao hardware físico. Testar e depurar um aplicativo é tarefa importante no processo de desenvolvimento do software. Isso também é válido para a criação de aplicativos móveis para aparelhos como smartphones e tablets. A implantação do aplicativo no simulador do Tablet BlackBerry permite aos desenvolvedores ver e testar o funcionamento do aplicativo em um Tablet PlayBook BlackBerry real usando o software VMware. Para testar o aplicativo no simulador do BlackBerry PlayBook usando o Prompt de Comando, execute as seguintes etapas: Inicie o simulador do BlackBerry PlayBook no VMware Player Ative o "Modo de desenvolvimento". O "Modo de Desenvolvimento" no simulador do Tablet PlayBook BlackBerry deve ser habilitado antes de carregar o aplicativo. Para habilitar o "Modo de Desenvolvimento", direito da tela do simulador clique no ícone da engrenagem no canto superior Figura 15: Habilitando o modo de desenvolvedor Na Tela de segurança, clique em "Modo de desenvolvimento". Para usar o rótulo Usar modo de desenvolvimento, defina a configuração do Modo de desenvolvimento como "ATIVADO". No campo 26 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Senha do aparelho (no menu principal Segurança), digite a senha para o seu tablet (a senha padrão do Tablet é "PlayBook"). Figura 16: Habilitando o modo de desenvolvedor Registre o endereço IP do simulador. Você pode visualizar o endereço de IP do tablet tocando no ícone à direita do relógio na barra de status Figura 17: Obtendo o endereço IP Abra um prompt de comando e navegue para a pasta bbwp\blackberry-tablet-sdk\bin, que está sob a pasta de instalação do BlackBerry WebWorks SDK. Digite o seguinte texto: Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 27

cd C:\Arquivos de programas\research In Motion\BlackBerry HTML5 WebWorks SDK para TabletOS 2.2.0.5\bbwp\blackberry-tablet-sdk\bin Digite o seguinte comando para carregar e executar o aplicativo no simulador: blackberry-deploy -installapp -password <senha do simulador> -device <endereço IP do simulador> -package <caminho do arquivo BAR> Figura 18: Empacotando o aplicativo usando o Prompt de comando do Windows Retorne ao simulador do PlayBook e clique na opção de menu "Todos". O ícone para o aplicativo "Hello World" deve ser apresentado como se vê abaixo: 28 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Figura 19: Aplicativo Hello World Clique no aplicativo "Hello World" para exibir o aplicativo Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 29

Figura 20: Aplicativo Hello World 30 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Implantando o aplicativo no simulador do Tablet usando o emulador Ripple Um aplicativo também pode ser implantado no simulador do BlackBerry PlayBook usando o emulador Ripple. Antes de implantar o aplicativo no simulador do BlackBerry PlayBook Certifique-se de definir as configurações de "Compilar" e "Iniciar" no emulador Ripple Armazene o arquivo do documento de configuração (config.xml) na raiz do projeto Verifique se o simulador do Tablet PlayBook já foi iniciado (no VMWare Player) Para implantar o aplicativo usando o emulador Ripple, Selecione o ícone de ferramenta localizado no canto superior direito do emulador Ripple Selecione "Empacotar e iniciar". O emulador Ripple compila o aplicativo Se a compilação e o empacotamento forem concluídos com êxito, a mensagem "Compilação bem-sucedida!" será exibida Figura 21: Compilação bem-sucedida Em aplicativos do tablet BlackBerry, os arquivos ".zip" e ". bar" do aplicativo são armazenados na pasta de saída especificada. O simulador do Tablet BlackBerry inicia o aplicativo. Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 31

Figura 22: Aplicativo Hello World iniciado no simulador do Tablet BlackBerry 32 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo

Resumo e mais aprendizagem Resumo Neste módulo, os seguintes tópicos foram abordados: Criar um arquivo "index.html" para um aplicativo Aproveitar um gráfico existente para um ícone do aplicativo Criar um arquivo "config.xml" para um aplicativo Empacotar arquivos de aplicativo usando o BlackBerry WebWorks Packager em um arquivo ".bar" Acessar um arquivo de projeto a partir de um servidor Web remoto no emulador Ripple para visualização do aplicativo Empacotar um aplicativo usando o emulador Ripple Implantar o aplicativo no simulador do BlackBerry Playbook usando o prompt de comando Empacotar e iniciar o aplicativo no simulador do PlayBook BlackBerry usando o emulador Ripple Mais aprendizagem Depois de concluir com sucesso este módulo, as próximas etapas incluem a obtenção de um aplicativo pronto para implantar em um Tablet. Essas etapas incluem: Configurar o computador de um desenvolvedor para solicitar chaves de assinatura de código Assinar um aplicativo para implantação em um Tablet Criando um token de depuração para implantar um aplicativo em um Tablet Usando a ferramenta Web Inspector para testar e depurar Informações sobre estas próximas etapas podem ser encontradas no "Módulo 4 - Testando, assinando e implantando um aplicativo no tablet BlackBerry PlayBook" Recursos adicionais A seguir, recursos extras que podem ser acessados para fornecer informações adicionais sobre os tópicos abordados neste módulo. Para mais informações sobre documentos de configuração, consulte Criando um documento de configuração WebWorks Para mais informações sobre o simulador do Tablet BlackBerry, consulte Usando o simulador do tablet. Para mais informações sobre como usar um servidor web remoto de código aberto como o Drop Box, visite os Fóruns de suporte do BlackBerry Para mais informações sobre como acessar projetos locais usando o Ripple, visite o portal BlackBerry HTML5 WebWorks Módulo 3 Desenvolvendo o primeiro aplicativo 2012 Research In Motion Limited 33

Para mais informações sobre definições de configuração adicionais no arquivo XML, visite Trabalhando com o arquivo de configuração XML 34 2012 Research In Motion Limited Módulo 3 Desenvolvendo o primeiro aplicativo