Aplicativos BlackBerry HTML5 WebWorks para o Tablet BlackBerry PlayBook Módulo 4 Testando, assinando e implantando um aplicativo
2 2012 Research In Motion Limited Módulo 4 Testando, Assinando, Implantando
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. Web Inspector é uma marca comercial da Wintriss Engineering Corporation.; Windows uma marca comercial da Microsoft Corporation; Windows Vista é uma marca comercial da Microsoft 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. 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 Módule 4 Testando, Assinando, Implantando 2012 Research In Motion Limited 3
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 4 Testando, Assinando, Implantando
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ódule 4 Testando, Assinando, Implantando 2012 Research In Motion Limited 5
Sumário Sobre este manual de trabalho... 5 Visão geral... 8 Introdução... 8 Objetivos... 8 Pré-requisitos recomendados... 8 Por que você deve assinar seu aplicativo?... 8 Configurando seu computador para assinar um aplicativo... 9 Etapas para configurar seu computador para assinar aplicativos... 9 A importância de fazer backup dos arquivos... 10 Assinando seu aplicativo... 11 Implantando um aplicativo não assinado no tablet BlackBerry PlayBook... 12 Usando tokens de depuração... 12 Antes de criar um token de depuração... 12 Criando um token de depuração... 13 Instalando um token de depuração... 13 Configurando um token de depuração... 14 Empacotando um aplicativo com um token de depuração... 14 Implantando um aplicativo no Tablet BlackBerry PlayBook... 15 Depurando usando a ferramenta Web Inspector... 16 Por que usar a ferramenta de Web Inspector... 16 Como ativar a ferramenta de Web Inspector para o navegador do BlackBerry Tablet OS 16 Usando a ferramenta Web Inspector para carregar conteúdo em tempo real do BlackBerry Tablet OS... 16 Resumo e mais aprendizagem... 18 Resumo... 18 Recursos adicionais... 18 6 2012 Research In Motion Limited Módulo 4 Testando, Assinando, Implantando
Módule 4 Testando, Assinando, Implantando 2012 Research In Motion Limited 7
Visão geral Introdução Para implantar um aplicativo BlackBerry HTML5 WebWorks para BlackBerry AppWorld, você terá de assiná-lo. Este módulo irá guiá-lo através das etapas necessárias para testar, assinar e implantar seu aplicativo BlackBerry HTML5 WebWorks. Objetivos Neste módulo, serão apresentados os seguintes conceitos ao aluno: Por que é importante assinar um aplicativo Como configurar o computador para assinar um aplicativo A importância de fazer backup dos arquivos Como assinar um aplicativo Como empacotar e implantar um aplicativo não assinado para um tablet usando tokens de depuração Como depurar um aplicativo no Tablet BlackBerry PlayBook usando a ferramenta Web Inspector do navegador PlayBook Pré requisitos recomendados Para este módulo, os pré-requisitos recomendados de habilidades e áreas de conhecimento são: A criação do laboratório "Hello World" do "Módulo 3 - Escrevendo seu primeiro aplicativo para o tablet BlackBerry PlayBook" Download e instalação do BlackBerry WebWorks SDK e Tablet BlackBerry PlayBook do "Módulo 2 - Instalação das ferramentas de desenvolvimento HTML5 WebWorks" Experiência em usar a ferramenta Prompt de comando do Windows Por que você deve assinar seu aplicativo? Antes que você possa distribuir um aplicativo para uso em um tablet BlackBerry PlayBook, o aplicativo deve ser assinado. A assinatura de um aplicativo permite que a RIM valide os recursos e identificadores únicos do aplicativo. Assinar um aplicativo também vincula a identidade de um desenvolvedor ao aplicativo como prova de autoria. A ferramenta de assinatura incluída no BlackBerry WebWorks SDK acrescenta valores hash criptográficos ao pacote de aplicativos (arquivo.bar) durante o processo de assinatura. Os arquivos de hash ajudam a verificar a autoria do aplicativo para os usuários e para o sistema operacional (SO). 8 2012 Research In Motion Limited Módulo 4 Testando, Assinando, Implantando
Configurando seu computador para assinar um aplicativo Antes de implantar um aplicativo no tablet BlackBerry PlayBook, o computador de um desenvolvedor pode precisar ser configurado. A configuração permite que um desenvolvedor para solicitar e instalar um token de depuração. Essas tarefas de configuração para a primeira configuração e só precisam ser executadas uma vez. Etapas para configurar seu computador para assinar aplicativos Antes de iniciar a configuração, você precisará solicitar chaves de assinatura de código. Chaves de assinatura de código podem ser solicitadas pelo preenchimento do formulário Web apropriado aqui. Lembre-se do PIN fornecido. O PIN protege você contra o uso de suas chaves de assinatura de código por terceiros não autorizados, ortanto mantenha-a em segurança. Depois que seu aplicativo for aceito, você receberá dois arquivos de registro ".csj" em duas mensagens de e-mail separadas. Estas mensagens fornecerão informações adicionais sobre cada arquivo e para que serão usados. Salve esses arquivos em um local seguro no seu computador. Os arquivos serão nomeados da seguinte forma: client-rdk-xxxxxx.csj - Este é o arquivo que você usa para assinar seus aplicativos e publicar na loha on-line BlackBerry App World client-pbdt-xxxxx.csj - Este arquivo é usado para gerar um token de depuração que você pode usar para testar o aplicativo em um tablet Lembre-se que esses arquivos só podem ser usados uma vez e que os tokens de depuração só duram 30 dias. Após 30 dias, os tokens de depuração devem ser recriados. Um aparelho BlackBerry físico manterá um token de depuração por 10 dias. Em seguida, registre-se com a Autoridade de assinatura RIM usando o arquivo de registro ".csj" para assinatura de aplicativos. Na pasta \bbwp\blackberry-tablet-sdk\bin localizada na pasta de instalação do BlackBerry WebWorks SDK, execute a ferramenta de assinatura ".bar" para se inscrever no servidor de autoridade de assinatura. No Prompt de comando, digite: blackberry-signer -register -csjpin <csj pin> -storepass <KeystorePassword> <client-rdk-xxxxxx.csj file> <client-pbdt-xxxxx.csj file> <pin csj> é o PIN especificado no formulário Web quando um desenvolvedor solicitou as chaves de assinatura de código Módule 4 Testando, Assinando, Implantando 2012 Research In Motion Limited 9
<senha de keystore> é uma senha especificada para o keystore <arquivo client-rdk-xxxxxx.csj> é o aplicativo que assina o arquivo ".csj" enviado por e-mail após o registro <arquivo client-pbdt-xxxxxx.csj> é o arquivo ".csj" do token de depuração enviado por e-mail após o registro Este comando cria os seguintes arquivos: author.p12, barsigner.csk e barsigner.db. A importância de fazer backup dos arquivos os arquivos ".csj" que foram utilizados para instalar as chaves de assinatura de código podem ser usados apenas uma vez. Eles estão desabilitados após uma instalação bem-sucedida. É importante fazer backup das chaves de assinatura de código depois que eles foram instalados. As chaves de assinatura de código podem ser restauradas para o computador original em que foram instaladas ou para outro computador, já que você pode transferir o código de assinatura de chaves para vários computadores e assinar a partir de qualquer um deles. Os arquivos barsigner estão localizados nos diretórios descritos. Estes são armazenados em um local central no diretório de perfil do usuário e usado por todas as ferramentas de desenvolvimento do BlackBerry Tablet OS Sua localização varia de acordo com o sistema operacional utilizado. Você terá de fazer o backup dos arquivos "author.p12.barsigner.csk" e "barsigner.db". Para restaurar as chaves de assinatura de código, copie os arquivos de volta no diretório descrito abaixo. Windows XP: %HOMEPATH%\Configurações locais\dados do aplicativo\research In Motion Windows Vista e Windows 7: %HOMEPATH%\Dados do aplicativo\local\research In Motion Por padrão, %HOMEPATH% é C:\Documentos e configurações no Windows XP e C:\Usuários no Windows Vista e Windows 7. Para restaurar as chaves de assinatura de código, copie os arquivos de volta no diretório descrito acima. 10 2012 Research In Motion Limited Módulo 4 Testando, Assinando, Implantando
Assinando seu aplicativo Um desenvolvedor pode assinar seu aplicativo BlackBerry HTML5 WebWorks ao mesmo tempo ele é compilado, usando a seguinte sintaxe com o BlackBerry WebWorks Packager: bbwp <archive_file> -g <KeystorePassword> -buildid <num> -o <output_location> <arquivo_comprimido> é o nome e a localização do arquivo comprimido do aplicativo <senha keystore> é a senha que você especificou para o keystore <núm> é o número da versão de compilação de seu aplicativo. Geralmente, esse número deve ser incrementado a partir da versão anterior assinada. <local_saída> é o local onde você quer que os arquivos de saída sejam criados Eis um exemplo de sintaxe de assinatura de código: bbwp C:\myarchive.zip -g mykeystorepassword -buildid 10 -o C:\myoutputdir Depois que um aplicativo é assinado, um desenvolvedor pode publicá-lo na loja BlackBerry AppWorld. Módule 4 Testando, Assinando, Implantando 2012 Research In Motion Limited 11
Implantando um aplicativo não assinado no tablet BlackBerry PlayBook Um aplicativo não assinado pode ser implantado em um Tablet BlackBerry PlayBook usando um token de depuração. Tokens de depuração permitem que um desenvolvedor separe o processo de criação e publicação de aplicativos. Usando um token de depuração, um desenvolvedor pode criar e testar um aplicativo e entregar o aplicativo ao cliente para assinatura e publicação. Usando tokens de depuração Executar um aplicativo não assinado usando um token de depuração permite que os desenvolvedores evitem: Alterar o número da versão do aplicativo Acessar a internet Exportar uma compilação de lançamento do aplicativo Um token de depuração deve ser criado por um indivíduo ou uma organização que tem permissão para assinar aplicativos BlackBerry Tablet OS. Para solicitar permissão para assinar aplicativos, preencha o formulário Web apropriado. Após o pedido para assinar aplicativos for aprovado, você receberá dois arquivos ".csj" enviados por dois e-mails separados. Um arquivo permite que você configure seu computador para assinar pedido e outro arquivo permite que um desenvolvedor crie tokens de depuração. Depois de um desenvolvedor recebe seus arquivos de registro ".csj", ele pode configurar seu computador para criar tokens de depuração. Quando um desenvolvedor cria um token de depuração, deve especificar o PIN para cada tablet em que o token pode ser usado. Eles podem distribuir os tokens de depuração que criam para que os desenvolvedores os instalem nesses tablets, ou instalá-los eles mesmos. Lembre-se que um desenvolvedor está limitado a um total de 100 PINs de tablet do total de tokens de depuração ativos. Se você criar tokens de depuração que abordam mais de 100 PINs, você deve esperar que alguns dos tokens de depuração expirem antes de criar mais. Tokens de depuração são válidos por 30 dias. Quando um token de depuração expira, o BlackBerry Tablet OS já não permite que aplicativos não assinados que dependem desse token sejam executados. Antes de criar um token de depuração O computador de um desenvolvedor deve ser configurado para solicitar tokens de depuração antes de começar a testar um aplicativo não assinado para um tablet. Saiba mais sobre como "Assinar seu aplicativo tablet". 12 2012 Research In Motion Limited Módulo 4 Testando, Assinando, Implantando
Criando um token de depuração Em um prompt de comando, navegue até a subpasta de bin onde você instalou o BlackBerry WebWorks SDK C:\Arquivos de programa\researchinmotion\... Para criar um símbolo de token para o seu aparelho, use a seguinte sintaxe e valores para as opções de linha de comando: blackberry-debugtokenrequest -storepass <KeystorePassword> - devicepin <PIN tablet> <debug_token_file_name.bar> A senha de keystore é definida quando as chaves de assinatura de código foram criadas durante a configuração do processo de computação. O PIN do tablet ié o PIN do Tablet BlackBerry PlayBook no qual você quer instalar esse token de depuração. Ele pode ser encontrado clicando no ícone, no menu "Sobre" e na opção "Hardware". O debug_token_file_name.bar é o nome do arquivo do token de depuração que está sendo criado. Se não for especificado um caminho que inclua um nome de arquivo, a ferramenta blackberrydebugtokenrequest excluirá o diretório especificado e não criará um token de depuração. O arquivo do token de depuração deve terminar com ".bar". Se você especificar o nome de um arquivo existente, a ferramenta blackberry-debugtokenrequest excluirá o arquivo antes criar o token de depuração. Após digitar a sintaxe no prompt de comando, um desenvolvedor pode agora distribuir ou instalar o token de depuração que foi criado. Instalando um token de depuração No hardware do Tablet BlackBerry PlayBook, abra as opções do tablet no canto superior direito da "Tela inicial" do Tablet BlackBerry PlayBook e pressione o ícone de engrenagem. 1. Na lista de opções, pressione "Segurança" 2. Na lista de opções de segurança, pressione "Mode de desenvolvimento" 3. Selecione "Carregar token de depuração" 4. Em um prompt de comando, insira o seguinte comando: blackberry-deploy -installdebugtoken <path to debug token> -device <IP address of tablet> -password <tablet password> Módule 4 Testando, Assinando, Implantando 2012 Research In Motion Limited 13
Configurando um token de depuração Depois de instalar o token de depuração, edite o arquivo bbwp.properties e inclua o caminho de depuração token usando as tags <token_depuração> para definir o token de depuração. Este arquivo está localizado na pasta "bbwp/bin". A sintaxe é a seguinte: <?xml version="1.0" encoding="utf-8"?> <wcp> <additional>quiet</additional> <java>c:\program Files\Research In Motion\BlackBerry WebWorks SDK for TabletOS 2.1.0\jre</java> <wcp_template>airapptemplates</wcp_template> <air_template>airapptemplates</air_template> <tablet_sdk>c:\program Files\Research In Motion\BlackBerry WebWorks SDK for TabletOS 2.1.0\bbwp\blackberry-tablet-sdk</tablet_sdk> <extension_repository>ext</extension_repository> <debug_token>c:\my_debug_token.bar</debug_token> </wcp> Um desenvolvedor pode agora carregar seu aplicativo habilitado para depuração em um aparelho tablet BlackBerry sem precisar assinar. Na tag <token_depuração>, digite o nome do arquivo e o local onde o token de depuração foi instalado. Empacotando um aplicativo com um token de depuração Para executar aplicativos não assinados usando um token de depuração, inclua o parâmetro "-d" ao compilar e empacotar o aplicativo. Esse parâmetro define o modo de desenvolvedor para o token de depuração. Informações do token de depuração só serão usadas se as seguintes informações forem verdadeiras: Há um elemento <token_depuração> no arquivo "bbwp.properties" e ele contém o nome completo do caminho de um arquivo de token de depuração válido A assinatura não foi especificada quando você empacotou o aplicativo Ao prompt de comando, navegue para a pasta de instalação do BlackBerry WebWorks Packager. O caminho do arquivo pode variar de acordo com o lugar onde você instalou o BlackBerry WebWorks Packager. Digite a seguinte sintaxe: cd C:\ProgramFiles\ResearchInMotion\BlackBerryWebWorks SDK for TabletOS<x.x.x.x>\bbwp O "xxxx" indica a versão do BlackBerry HTML5 WebWorks SDK que foi baixado e instalado. Durante o processo de compilação, o BlackBerry WebWorks Packager exibe várias mensagens, e indicará uma compilação bem-sucedida se o arquivo do aplicativo não contiver erros. Compile o aplicativo usando a seguinte sintaxe: bbwp [drive:][path]archive -d [-o dir] Exemplo: bbwp C:\myapp\myarchive.zip d o C:\myapp\saída 14 2012 Research In Motion Limited Módulo 4 Testando, Assinando, Implantando
Se bem-sucedido, esse processo criará um arquivo a.bar na pasta especificada pelo parâmetro -o. Se nenhum parâmetro o- for especificado, o arquivo.bar será criado em uma subpasta chamada "bin" que está localizado na mesma pasta do arquivo comprimido. Se nenhum parâmetro o- for especificado, o arquivo.bar será criado em uma subpasta chamada "bin" que está localizado na mesma pasta do arquivo comprimido. O arquivo ".bar" pode agora ser implantado no tablet BlackBerry PlayBook. Implantando um aplicativo no Tablet BlackBerry PlayBook 1. Ative o "Modo de desenvolvimento" no tablet PlayBook BlackBerry 2. Obtenha o endereço IP do tablet BlackBerry PlayBook 3. Ao prompt de comando, navegue até a pasta de instalação do BlackBerry WebWorks Packager 4. Implante o aplicativo usando a seguinte sintaxe blackberry-deploy -installapp -password <tablet password> -device <IP_address> -package <BAR file path> Exemplo: blackberry-deploy -installapp -password playbook -device 111.111.111.11 package C:\myapp\output\hw.bar Para usar a ferramenta Web Inspector para depuração de um aplicativo, use o operador de comando " d" na sintaxe acima ao compilar o aplicativo. Exemplo: c:\myapp\hw.zip d Módule 4 Testando, Assinando, Implantando 2012 Research In Motion Limited 15
Depurando usando a ferramenta Web Inspector A ferramenta Web Inspector é uma ferramenta de desenvolvimento de depuração e perfil para conteúdo Web, incluída como parte do mecanismo de renderização WebKit. Inclui uma variedade de recursos e capacidades, como inspeção, perfis, integração do console e muito mais. Por que usar a ferramenta de Web Inspector Um desafio que os desenvolvedores da Web móvel têm experimentado é que a ferramenta Web Inspector é facilmente acessível para uso com conteúdo carregado diretamente em navegadores de desktop habilitados para WebKit, mas não necessariamente para conteúdo carregado em um dispositivo móvel. Agora os desenvolvedores podem usar a ferramenta Web Inspector para depurar e traçar o perfil do conteúdo web em tempo real e aplicativos HTML5 WebWorks executados em um Tablet BlackBerry PlayBook ou simulador. A ferramenta Web Inspector é um dos utilitários mais completos e poderosos que os desenvolvedores da Web podem usar para solucionar problemas e otimizar o conteúdo Web. Como ativar a ferramenta de Web Inspector para o navegador do BlackBerry Tablet OS 1. Selecione a opção "Privacidade e Segurança" na tela "Opções do navegador" do seu tablet BlackBerry PlayBook 2. Mude "Ativar Web Inspector" para "ATIVADO" 3. Quando solicitado, digite a senha do Tablet BlackBerry PlayBook. Depois de inserir a senha, a ferramenta Web Inspector será habilitada. Usando a ferramenta Web Inspector para carregar conteúdo em tempo real do BlackBerry Tablet OS 1. Abra um navegador web de desktop, como o Chrome, Firefox, Safari ou Internet Explorer 2. Na barra de endereços, digite o endereço IP do tablet BlackBerry PlayBook de destino e a porta 1337 (por exemplo http://198.168.1.7:1337). 3. Será exibida uma lista de títulos de páginas de conteúdo, carregada na memória pela ferramenta Inspector Web (como conteúdo de navegador ou um aplicativo BlackBerry HTML5 WebWorks). 4. Clique em qualquer um dos títulos de página para começar a usar a ferramenta Web Inspector para depurar e traçar o perfil de seu conteúdo Web. Observação: Um aplicativo HTML5 WebWorks só estará disponível no índice do Web Inspector se tiver sido compilado (usando o Prompt de comando do Windows ) com o operador de linha de comando "-d" utilizando as etapas descritas na seção "Implantando um aplicativo no tablet" Para obter informações adicionais, consulte http://devblog.blackberry.com/2011/06/debugging-blackberry-web-apps/. 16 2012 Research In Motion Limited Módulo 4 Testando, Assinando, Implantando
Módule 4 Testando, Assinando, Implantando 2012 Research In Motion Limited 17
Resumo e mais aprendizagem Resumo Neste módulo, abrangemos os seguintes tópicos: A importância de assinar seu aplicativo Configurando um computador para assinar um aplicativo A importância de fazer backup dos arquivos Como assinar um aplicativo Como implantar um aplicativo não assinado Como criar e instalar um token de depuração Empacotando e implantando um aplicativo não assinado em um tablet Usando a ferramenta Web Inspector no navegador PlayBook para depurar Recursos adicionais Em seguida, procure formas de integrar os recursos adicionais em seu aplicativo, tais como: - Localização geográfica - Monetização e pagamento - Elementos de interface de usuário (UI) avançada Informações adicionais, incluindo código de exemplo, sobre a integração desses recursos em um aplicativo pode ser encontrado no site BlackBerry Jam. Se o seu aplicativo estiver pronto, aprenda mais sobre como distribuí-lo via BlackBerry AppWorld. Para mais informações sobre assinatura de código, consulte Chaves de assinatura de código: passado presente e futuro. 18 2012 Research In Motion Limited Módulo 4 Testando, Assinando, Implantando