Aplicativos BlackBerry HTML5 WebWorks para o Tablet BlackBerry

Transcrição

Aplicativos
BlackBerry HTML5
WebWorks para o
Tablet BlackBerry®
PlayBook™
Módulo 4 – Testando,
assinando e implantando
um aplicativo
Aplicativos BlackBerry HTML5 WebWorks
2
© 2012 Research In Motion Limited Módulo 4 – Testando, Assinando, Implantando
v0.01
© 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
v0.01
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
v0.01
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.
v0.01
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
v0.01
v0.01
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
v0.01
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
v0.01
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
v0.01
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.
v0.01
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
v0.01
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>
v0.01
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
v0.01
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.
2.
3.
4.
Ative o "Modo de desenvolvimento" no tablet PlayBook BlackBerry
Obtenha o endereço IP do tablet BlackBerry PlayBook
Ao prompt de comando, navegue até a pasta de instalação do BlackBerry WebWorks Packager
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
v0.01
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
v0.01
v0.01
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
v0.01

Aplicativos BlackBerry HTML5 WebWorks para o Tablet BlackBerry

Transcrição

Documentos relacionados

BLACKBERRY EM ROAMING INTERNACIONAL

BlackBerry Quick Search powered by Google License Notice

SOFTWARE BLACKBERRY MAPS CONFIRMAÇÃO DE LICENÇA

Instruções Instalação Software XCPPRO

BlackBerry Quick Search powered by Google License Notice

declaração de conformidade

Casos de Sucesso com Clientes BlackBerry

Historia de Éxito de Clientes de BlackBerry

Distributing Applications

Casos de Sucesso com Clientes BlackBerry