BlackBerry Java Development Environment Versão: Guia de fundamentos

Transcrição

1 BlackBerry Java Development Environment Versão: Guia de fundamentos

2 Publicado: SWDT

3 Conteúdo 1 Compreendendo o BlackBerry e a programação de dispositivos BlackBerry... 5 Princípios usados no projeto de dispositivos BlackBerry... 5 Ciclos de lançamento e versões... 6 BlackBerry Java Development Environment... 6 APIs Java MEe Java para BlackBerry... 7 Suporte a APIs Java padrão... 7 Suporte a extensões de API Java... 8 Soluções BlackBerry... 9 BlackBerry Enterprise Solution... 9 BlackBerry Internet Service... 9 BlackBerry MDS Projeto do BlackBerry Java Application Aplicativos independentes Aplicativos com sincronização de desktop Aplicativos com acesso à rede sem fio, sincronização sem fio ou recursos de alerta sem fio Aplicativos MIDlet Aplicativos CLDC Controle de API e assinatura de código Modelagem de objeto Multithreading Prática recomendada: Usando multithreading Práticas recomendadas para escrever de forma eficiente um BlackBerry Java Application Prática recomendada: Escrevendo códigos eficientes Prática recomendada: Usando os objetos de forma criteriosa Prática recomendada: Reduzindo o tamanho do código compilado Suporte a vários idiomas Prática recomendada: Armazenando strings de texto em arquivos de recursos Suporte a multimídia Suporte a áudio Suporte a câmera Suporte a vídeo Projeto da interface do usuário e da navegação... 24

4 Navegação e ação do usuário do dispositivo BlackBerry Trackwheel e trackball Criando uma interface de usuário que seja consistente com as interfaces padrão do BlackBerry Gerenciamento de memória Gerenciando a memória Memória do dispositivo BlackBerry Principais recursos a serem reservados Prática recomendada: Minimizando o uso da memória Gerenciando situações de pouca memória disponível Identificando situações de pouca memória disponível em um dispositivo BlackBerry Economizando recursos Prática recomendada: Usando uma seleção de estrutura de dados eficiente Prática recomendada: Consolidando objetos em grupos de objetos Coleta de lixo em um dispositivo BlackBerry Coleta de lixo de RAM em um dispositivo BlackBerry Coleta de lixo completa em um dispositivo BlackBerry Coleta de lixo em um dispositivo BlackBerry inativo Gerenciamento de dados Suporte a APIS para armazenamento de dados em memória persistente APIs de armazenamento persistente APIs do sistema de gerenciamento de registros do MIDP APIs File Connection Armazenamento em mídia removível Acessando dados no cartão de memória microsd Fazendo backup e sincronizando dados Transporte sem fio de dados Gateways sem fio Usando o BlackBerry Enterprise Server como um gateway de rede Usando o gateway de Internet do provedor de serviços sem fio Opções alternativas de transporte de dados Usando para transportar dados Usando SMS para transportar dados Usando mensagens PIN para transportar dados... 34

5 7 Integração de aplicativos BlackBerry Adicionando itens de menu personalizados Integração com aplicativos do BlackBerry Device Software Acessando e dados do organizador Usando o BlackBerry Messenger com um BlackBerry Application Usando ouvintes para responder a alterações de aplicativos Considerações sobre segurança Criptografia de dados e o BlackBerry Application Criptografia de dados em transporte Criptografia de dados no dispositivo BlackBerry Acesso à memória Autenticação Autenticação do dispositivo BlackBerry e política de TI Autenticação do aplicativo Autenticação no servidor APIs controladas e assinatura de código APIs do BlackBerry com acesso controlado Suporte a políticas de TI Controle de aplicativos Criptografia de arquivos em cartões microsd Criptografia de dados em um cartão de memória microsd Usando o cartão de memória microsd com mais de um dispositivo BlackBerry Políticas de TI e o cartão de memória microsd Testar um BlackBerry Java Application Ofuscação de um BlackBerry Java Application Pré-verificação de um BlackBerry Java Application Testando aplicativos em um BlackBerry Smartphone Simulator Testando aplicativos em um dispositivo BlackBerry Simuladores do BlackBerry BlackBerry Smartphone Simulator BlackBerry MDS Simulator BlackBerry Simulator... 44

6 10 Disponibilizando os aplicativos Distribuição de aplicativos por meio de uma conexão de computador Distribuir um aplicativo a partir de um computador Distribuir um aplicativo a partir de uma página da Web Distribuir um aplicativo para testes Distribuição de aplicativos pela rede sem fio Recebimento sem fio (iniciado pelo usuário) Envio sem fio (iniciado pelo servidor) Glossário Aviso legal... 50

7 Compreendendo o BlackBerry e a programação de dispositivos BlackBerry Compreendendo o BlackBerry e a programação de dispositivos BlackBerry 1 Os dispositivos BlackBerry fornecem um ambiente sem fio Java ME compatível com aplicativos cliente/servidor. Os desenvolvedores de aplicativo podem criar um BlackBerry Java Application que tenha interfaces de usuário sofisticadas para entrada de dados e pesquisa e que ofereça suporte a multithreading, internacionalização, comunicação em rede e armazenamento de dados local. Os aplicativos podem se comunicar com as redes usando conexões TCP e HTTP padrão, independentemente da rede sem fio subjacente. Os desenvolvedores de aplicativos também podem criar um BlackBerry Java Application que seja estreitamente integrado aos aplicativos de dispositivos BlackBerry principais, como lista de mensagens, aplicativos organizadores, telefone e navegador, para proporcionarem aos usuários uma capacidade de operação simples. Princípios usados no projeto de dispositivos BlackBerry Os aplicativos projetados para os dispositivos BlackBerry devem oferecer um equilíbrio entre a melhor experiência possível para o usuário e uma vida útil longa da bateria. Ao projetar seu aplicativo para o dispositivo BlackBerry, leve em consideração as diferenças entre os dispositivos móveis e os computadores. Dispositivos móveis têm um tamanho de tela menor que pode exibir um número limitado de caracteres têm velocidades mais lentas de processador usam redes sem fio que têm um período de latência mais longo do que as LANs padrão têm menos memória disponível têm vida útil mais curta da bateria exibem uma tela de cada vez Nos dispositivos móveis, os usuários utilizam os aplicativos de forma diferente que usariam em um computador. Nos dispositivos móveis, os usuários esperam encontrar as informações rapidamente. Por exemplo, um sistema de CRM pode oferecer uma enorme quantidade de informações, mas os usuários precisam apenas de uma pequena quantidade dessas informações de cada vez. A interface do usuário do dispositivo BlackBerry foi projetada para que os usuários possam realizar as tarefas com facilidade e acessar as informações rapidamente. Ao projetar aplicativos para dispositivos BlackBerry, tente manter a maior compatibilidade possível com os outros aplicativos do dispositivo. Considere as seguintes diretrizes: Use ou estenda os componentes existentes da interface do usuário onde possível para que o seu aplicativo possa herdar o comportamento padrão do componente. Siga o máximo possível o modelo de navegação padrão para que os usuários possam fazer pleno uso do teclado e do trackball. Disponibilize todas as ações pelo menu. Verifique se as ações disponíveis no menu são relevantes para o contexto atual dos usuários. 5

8 Ciclos de lançamento e versões Ao projetar seu aplicativo, também leve em consideração as seguintes diretrizes: Concentre-se na tarefa imediata dos usuários. Simplifique a seleção e a apresentação dos dados para que sejam exibidas apenas as informações que os usuários precisam em um determinado momento. Exiba as informações usando de forma eficiente a tela pequena. Antes de projetar o aplicativo, considere o uso dos principais aplicativos no dispositivo BlackBerry ou do BlackBerry Smartphone Simulator para obter mais informações sobre o modelo de navegação e as práticas recomendadas para o projeto da interface do usuário. Ciclos de lançamento e versões Todos os dispositivos BlackBerry incluem uma versão específica do BlackBerry Device Software e da BlackBerry Java Virtual Machine. Para determinar a versão do BlackBerry Device Software para um dispositivo BlackBerry, em Options (Opções), clique em About (Sobre). Você pode atualizar o BlackBerry Device Software. Por exemplo, você pode atualizar um dispositivo BlackBerry com o BlackBerry Device Software 4.0 para o BlackBerry Device Software 4.1. Em cada versão principal do BlackBerry Device Software e do BlackBerry JVM, a Research In Motion inclui as APIs Java correspondentes e a versão do BlackBerry Java Development Environment. A versão do BlackBerry Device Software determina a versão do BlackBerry Integrated Development Environment que você pode usar para desenvolver aplicativos. Por exemplo, a RIM lançou o BlackBerry Device Software 4.0 e o BlackBerry JDE 4.0 ao mesmo tempo. O BlackBerry JDE 4.0 inclui suporte às APIs que foram apresentadas no BlackBerry Device Software 4.0 e no BlackBerry JVM 4.0. Os aplicativos criados usando o BlackBerry JDE 4.0 funcionam apenas nos dispositivos BlackBerry com o BlackBerry Device Software 4.0 ou posterior. Você pode usar os seguintes critérios para decidir qual versão do BlackBerry JDE deve ser usada no desenvolvimento de um aplicativo: Se o aplicativo não precisar usar recursos de hardware específicos do dispositivo BlackBerry ou extensões de API lançadas recentemente, use o BlackBerry JDE 4.0 para desenvolvê-lo. Se o aplicativo for projetado para ser executado apenas no smartphone BlackBerry Pearl 8100, use o BlackBerry JDE 4.2 ou posterior. BlackBerry Java Development Environment O BlackBerry Java Development Environment é um ambiente de desenvolvimento e simulação totalmente integrado para a criação de um BlackBerry Java Application para dispositivos BlackBerry. Com o BlackBerry JDE, os desenvolvedores podem criar aplicativos usando a linguagem de programação Java ME e as APIs Java estendidas para BlackBerry. O BlackBerry Java Development Environment inclui as seguintes ferramentas de desenvolvimento: BlackBerry Integrated Development Environment BlackBerry Smartphone Simulator APIs Java ME e APIs do BlackBerry 6

9 APIs Java MEe Java para BlackBerry os mesmos aplicativos O BlackBerry IDE inclui um conjunto completo de ferramentas de edição e depuração que são otimizadas para o desenvolvimento de um BlackBerry Java Application. O BlackBerry Smartphone Simulator oferece um ambiente tipo Windows completo e foi projetado para simular interfaces de usuário e interação do usuário, conexões de rede, serviços de e sincronização sem fio de dados. O pacote de componentes BlackBerry Java Development Environment inclui as seguintes ferramentas para desenvolvimento em IDEs de terceiros como NetBeans ou Eclipse : RAPC: use este compilador de prompt de comando para compilar arquivos.java e.jar em arquivos.cod que podem ser executados no BlackBerry Smartphone Simulator ou em um dispositivo BlackBerry. JavaLoader: use esta ferramenta para adicionar ou atualizar um aplicativo em um dispositivo BlackBerry para teste e para exibir informações sobre os arquivos.cod do aplicativo. BlackBerry Signature Tool: use esta ferramenta para enviar solicitações de assinatura de código para a BlackBerry Signing Authority Tool. Preverify Tool: use esta ferramenta para verificar parcialmente as classes antes de carregar o aplicativo em um dispositivo BlackBerry. JDWP: use esta ferramenta para depurar os aplicativos usando ambientes de desenvolvimento integrados de terceiros. APIs Java MEe Java para BlackBerry Java ME é uma plataforma de padrão industrial que define conjuntos comuns de APIs Java para diferentes tipos de dispositivos sem fio e incorporados. O aplicativo Java ME no dispositivo BlackBerry é executado na BlackBerry Java Virtual Machine, que fornece todos os serviços de tempo de execução aos aplicativos e realiza funções como alocação de memória típica, verificações de segurança e coleta de lixo. O padrão Java ME MIDP gerencia as necessidades da API e da BlackBerry JVM de um dispositivo sem fio restrito com uma interface de usuário. O dispositivo BlackBerry oferece suporte ao padrão Java ME MIDP conforme definido no JSR 118. O padrão Java ME MIDP fornece um conjunto principal de APIs Java que podem ser suportadas por qualquer dispositivo BlackBerry, independentemente do sistema operacional subjacente. Em geral, os desenvolvedores podem criar um aplicativo Java usando APIs MIDP padrão e executar esse aplicativo em diferentes tipos de dispositivo. Suporte a APIs Java padrão O dispositivo BlackBerry e o BlackBerry Java Development Environment oferecem suporte ao padrão MIDP Java ME, que oferece um conjunto principal de APIs Java que você pode usar para desenvolver aplicativos para dispositivo sem fio. O dispositivo BlackBerry e o BlackBerry Java Development Environment também oferecem suporte aos seguintes JSRs: JSR 30: Connected Limited Device Configuration versão 1.0 (suportado nos dispositivos com BlackBerry Device Software 4.0 ou anterior) 7

10 APIs Java MEe Java para BlackBerry JSR 37: Mobile Information Device Profile versão 1.0 (suportado nos dispositivos com BlackBerry Device Software 4.0 ou anterior) JSR 75: Portable Optional Packages para suporte à plataforma J2ME (PDAP) apenas para APIs de PIM e API File Connection para Java ME (suportado apenas nos dispositivos com BlackBerry Device Software 4.2 ou posterior) JSR 82: Java APIs para Bluetooth JSR 118: Mobile Information Device Profile versão 2.0 JSR 120: Wireless Messaging API (WMA) versão 1.1 JSR 135: Mobile Media APIs (MM API) versão 1.1 JSR 139: Connected Limited Device Configuration versão 1.1 JSR 172: J2ME Web Services JSR 177: Security and Trust Services API para J2ME (SATSA) JSR 179: Location API para Java ME JSR 185: Java Technology for the Wireless Industry (JTWI) JSR 205: Wireless Messaging API 2.0 JSR 211: Content Handler API JSR 226: Scalable 2D Vector Graphics API para Java ME JSR 238: Mobile Internationalization API Suporte a extensões de API Java Os dispositivos BlackBerry oferecem suporte às seguintes APIs Java que não fazem parte das definições de JSR padrão e que podem oferecer mais recursos e maior funcionalidade em relação ao que é disponibilizado na bibliotecas de API MIDP padrão. API APIs de interface do usuário APIs de armazenamento de dados persistentes APIs de rede e E/S Ouvintes de eventos Descrição Use estas APIS para criar telas, itens de menu e todos os componentes da interface do usuário. Use estas APIS para armazenar dados personalizados localmente no seu aplicativo. Use estas APIS para estabelecer conexões de rede e ler ou gravar dados em um aplicativo no servidor. Use os Ouvintes de eventos para responder a eventos iniciados pelo sistema ou pelo usuário em um dispositivo BlackBerry. APIs de integração de aplicativos Use estas APIS para fazer a integração de aplicativos BlackBerry existentes de e- mail, telefone, calendário, contatos, navegador, câmera, media player e lista de tarefas. 8

11 Soluções BlackBerry API Utilitários adicionais Descrição Use estas APIS adicionais para criptografia e compactação de dados, análise de XML, conectividade Bluetooth, serviços baseados em localização etc. Soluções BlackBerry Os usuários de dispositivos BlackBerry podem usar o BlackBerry Enterprise Server ou o BlackBerry Internet Service, ou os dois no mesmo dispositivo. É importante saber as diferenças entre o BlackBerry Enterprise Server e o BlackBerry Internet Service, e a quais tipos de usuário será oferecido suporte, visto que isso pode afetar os modos de transporte usados e o modo como você gerencia a sincronização de dados. BlackBerry Enterprise Solution O BlackBerry Enterprise Server faz parte da BlackBerry Enterprise Solution. Sob a proteção do firewall corporativo, o BlackBerry Enterprise Server fornece um gateway sem fio para que os usuários de dispositivos BlackBerry de uma organização acessem corporativo e dados do organizador. Ele também oferece os seguintes recursos principais: criptografia e compactação de dados gerenciamento de dispositivos BlackBerry e utilitários de monitoramento aprovisionamento simplificado de aplicativos gateway autenticado para acesso à intranet em um BlackBerry Java Application BlackBerry Internet Service Os usuários de dispositivos BlackBerry que não estiverem associados a um BlackBerry Enterprise Server poderão usar o BlackBerry Internet Service. O BlackBerry Internet Service é um serviço de e Internet para dispositivos BlackBerry, projetado para fornecer aos usuários entrega automática de mensagens de , acesso sem fio a anexos de e acesso ao conteúdo da Internet. O BlackBerry Internet Service inclui suporte a conectividade HTTP direta e TCP/IP à Internet a partir de um BlackBerry Java Application de terceiros. BlackBerry MDS Para permitir que um BlackBerry Java Application acesse os recursos sob a proteção do firewall corporativo, o BlackBerry Enterprise Server inclui o BlackBerry Mobile Data System. O BlackBerry MDS fornece proxies HTTP e TCP/IP para um BlackBerry Java Application, que permite que o dispositivo BlackBerry se comunique com os servidores de aplicativos e da Web sob a proteção do firewall corporativo sem software VPN adicional. Os aplicativos que enviam dados usando o BlackBerry Enterprise Server como gateway aproveitam a conectividade corporativa simplificada, a criptografia e compactação de dados e a independência 9

12 Soluções BlackBerry da rede sem fio oferecidas pela BlackBerry Enterprise Solution. O BlackBerry MDS também fornece uma interface aberta, permitindo que os aplicativos do servidor sob a proteção do firewall corporativo enviem conteúdo aos aplicativos nos dispositivos BlackBerry. 10

13 Projeto do BlackBerry Java Application Projeto do BlackBerry Java Application 2 Aplicativos independentes Você pode usar as APIs do BlackBerry para criar aplicativos independentes, como jogos e guias de referência estáticos que podem ser executados como aplicativos off-line. Você também pode adicionar os dados de recursos necessários a um aplicativo antes de compilá-lo. Os usuários de dispositivos BlackBerry podem instalar o aplicativo pela rede sem fio ou com o BlackBerry Desktop Software. Depois que um aplicativo é instalado no dispositivo BlackBerry, ele não precisa se conectar à rede sem fio nem ao computador. Aplicativos com sincronização de desktop Você pode usar as APIs do BlackBerry para criar aplicativos com recursos de sincronização de desktop, como guias de referência e aplicativos organizadores. O usuário conecta o dispositivo BlackBerry a um computador para gerenciar e sincronizar os dados que estão localizados no computador. A Research In Motion não fornece canais HotSync ou qualquer outro módulo de sincronização direta de banco de dados. Você deve criar o código de sincronização e o usuário do dispositivo BlackBerry deve iniciar o processo de sincronização de dados manualmente. Após o aplicativo ser instalado no dispositivo BlackBerry, o usuário deve sincronizar as informações manualmente conectando o dispositivo ao computador por meio de uma conexão serial, USB ou Bluetooth. Aplicativos com acesso à rede sem fio, sincronização sem fio ou recursos de alerta sem fio Use as APIs do BlackBerry para criar aplicativos que enviem o conteúdo de forma proativa pela rede sem fio para os dispositivos BlackBerry em ambientes que usam o BlackBerry Enterprise Server. O BlackBerry Java Application para dispositivos BlackBerry usa uma conexão sem fio com a Internet ou com a intranet corporativa para fornecer aos usuários de dispositivos BlackBerry acesso a dados e aplicativos remotos. O BlackBerry Java Development Environment fornece APIs que você pode usar nos aplicativos para estabelecer conexões de rede com os servidores na Internet ou intranet corporativa. Aplicativos MIDlet O modelo de aplicativo Midlet faz parte da especificação MIDP. A classe principal de um MIDlet sempre estende a classe MIDlet e deve usar métodos para startapp(), pauseapp() e destroyapp(). 11

14 Aplicativos CLDC Vantagens Os aplicativos são compatíveis com outros dispositivos que também oferecem suporte à especificação MIDP. Desvantagens Os aplicativos podem usar apenas as APIs de interface de usuário existentes na biblioteca javax.microedition.lcdui padrão. O modelo pressupõe que todos os processos do aplicativo terminam quando o aplicativo é fechado. Os aplicativos não podem ser automaticamente iniciados em segundo plano quando o dispositivo é ativado. Aplicativos CLDC CLDC é uma especificação de um framework para Java ME. Um aplicativo CLDC pode estender a classe Application e começa com um método main() padrão. A maioria dos exemplos de aplicativos que o BlackBerry Java Development Environment inclui usa APIs do CLDC, APIs do BlackBerrye APIs do MIDP. Todos os aplicativos BlackBerry Device Software principais (incluindo lista de mensagens, lista de contatos, calendário e navegador) usam APIs do CLDC e APIs do BlackBerry. Vantagens Os aplicativos são compatíveis com outras plataformas. Desvantagens Os aplicativos não podem executar threads ativos em segundo plano após serem fechados. Os aplicativos não podem aproveitar as APIs de comunicação entre processos (IPC) para trocar informações com outros aplicativos. Os aplicativos não podem acessar eventos da tela de toque no dispositivo BlackBerry. Os aplicativos não podem usar dados do acelerômetro no dispositivo BlackBerry. Os aplicativos não podem integrar o BlackBerry Browser nem o BlackBerry Maps na interface de usuário. Os aplicativos não podem alterar o ícone exibido na tela inicial. Os aplicativos não podem acessar eventos do trackball e trackwheel. 12

15 Controle de API e assinatura de código Controle de API e assinatura de código Ao desenvolver um BlackBerry Java Application para dispositivos BlackBerry, você pode usar apenas as APIs Java públicas publicadas em documentos Javadoc no BlackBerry Java Development Environment. A BlackBerry Java Virtual Machine no dispositivo BlackBerry foi projetada para proteger o sistema operacional e os dados subjacentes, para que os aplicativos não possam usar APIs não documentadas ou não suportadas nem acessar dados que não sejam explicitamente expostos pelas APIs. Se você tentar usar APIs Java que não tenham sido expostas publicamente, o aplicativo receberá uma mensagem de erro ao ser executado. As APIs públicas são abertas ou assinadas. As APIs assinadas expõem os métodos de acesso a dados do usuário ou outras informações no dispositivo BlackBerry que são considerados confidenciais. Você pode usar APIs assinadas, mas antes deve solicitar e receber um conjunto de chaves de assinatura de código da Research In Motion. Depois, você precisa assinar digitalmente seu aplicativo para poder instalá-lo em um dispositivo BlackBerry. A assinatura de código não certifica ou aprova um aplicativo; apenas permite que a RIM identifique o autor de um aplicativo que usa APIs confidenciais, caso seja um aplicativo malintencionado. Para solicitar um conjunto de chaves de assinatura de código, visite codekeys.jsp. Você receberá seu conjunto de chaves de assinatura de código em aproximadamente 10 dias. Modelagem de objeto Independentemente de usar o modelo de aplicativo MIDlet ou CLDC, você deve usar uma abordagem orientada a objeto ao projetar o aplicativo para o dispositivo BlackBerry. Em uma abordagem orientada a objeto, os desenvolvedores usam objetos para conter os códigos comuns a um processo ou a uma função específica. Por exemplo, o desenvolvedor pode usar objetos diferentes para controlar atividade de rede, armazenamento de dados, processamento e manipulação de dados, e interação de interface de usuário. Ao desenvolver o aplicativo, é importante ter um bom modelo de objeto como base. Multithreading O sistema operacional do BlackBerry é um sistema operacional multithreaded, o que significa que vários aplicativos e processos podem ser rapidamente executados ao mesmo tempo no dispositivo BlackBerry. Por exemplo, os aplicativos podem usar threads em segundo plano para gerenciar tarefas de processamento intenso ou comunicações de rede de modo a não afetarem o thread principal. Se um aplicativo criar threads em segundo plano e o usuário do dispositivo BlackBerry fechar o aplicativo, esses threads poderão permanecer ativos. 13

16 Práticas recomendadas para escrever de forma eficiente um BlackBerry Java Application Prática recomendada: Usando multithreading Faça uso eficiente dos recursos de multithreading do sistema operacional BlackBerry. Especificamente, sempre crie um novo thread para conexões de rede ou outras operações longas (com mais de um décimo de segundo). Use threads em segundo plano para ouvintes ou outros processos que sejam executados em segundo plano durante a inicialização do aplicativo. Práticas recomendadas para escrever de forma eficiente um BlackBerry Java Application Prática recomendada: Escrevendo códigos eficientes Para possibilitar que um BlackBerry Java Application use os recursos de forma eficiente, considere as seguintes diretrizes: Use variáveis locais. Use shorthand para avaliar as condições Booleanas. Torne as classes finais. Use int em vez de long. Evite a coleta de lixo. Use variáveis estáticas para Strings. Evite o construtor String(String). Use uma Stringestática final ou não-final, dependendo dos requisitos do seu aplicativo. Escreva loops eficientes. Otimize as subexpressões. Otimize as operações de divisão. Evite java.util.enumeration. Execute conversões usando instanceof. Avalie as condições usando instanceof. Evite usar StringBuffer.append (StringBuffer). Evite retornar null. Evite passar null para os métodos. Tenha cuidado ao passar null para um construtor. Use long para identificadores exclusivos. Saia dos aplicativos corretamente. Imprima o rastreamento de pilha. 14

17 Práticas recomendadas para escrever de forma eficiente um BlackBerry Java Application Usando variáveis locais Use variáveis locais sempre que possível. O acesso a variáveis locais é mais eficiente do que o acesso a membros de classe. Usando shorthand para avaliar as condições Booleanas Para avaliar uma condição Boolean, use shorthand. O código compilado resultante é menor. Exemplo de código return( boolean_expression ); Tornando as classes finais Ao criar bibliotecas de código, marque as classes como final se souber que os desenvolvedores nunca irão ampliá-las. A presença da palavra-chave final permite que o compilador gere um código mais eficiente. Por padrão, o compilador do BlackBerry Java Development Environment marca todas as classes que você não estende no arquivo.cod de um aplicativo como final. Usando int em vez de long No Java, um long é um número inteiro de 64 bits. Como os dispositivos BlackBerry usam um processador de 32 bits, as operações podem ser executadas duas a quatro vezes mais rápido se você usar um int em vez de um long. Evitando a coleta de lixo Evite chamar System.gc() para executar uma operação de coleta de lixo pois esse procedimento pode ser muito demorado nos dispositivos BlackBerry com memória disponível limitada. Deixe que a BlackBerry Java Virtual Machine colete o lixo. Usando variáveis estáticas para Strings Ao definir campos estáticos (também denominados campos de classe) do tipo String, você pode aumentar a velocidade do aplicativo usando variáveis estáticas (sem a palavra-chave final) em vez de constantes (final). O contrário é verdadeiro para tipos de dados primitivos, como int. Por exemplo, você pode criar um objeto String como a seguir: private static final String x ="example"; 15

18 Práticas recomendadas para escrever de forma eficiente um BlackBerry Java Application Para essa constante estática (indicada pela palavra-chave final ), cada vez que você usa a constante, é criada uma instância de String temporária. O compilador elimina o "x" e o substitui pela string "example" no código de bytes, para que a BlackBerry Java Virtual Machine realize uma busca de tabela de hash cada vez que você fizer referência ao "x". Por outro lado, para uma variável estática (sem a palavra-chave final ), a String é criada apenas uma vez. O BlackBerry JVM realiza a busca de tabela de hash apenas quando inicia o "x", portanto o acesso é mais rápido. private static String x = "example"; Você pode usar constantes públicas (ou seja, campos final ), mas você deve marcas as variáveis como privadas. Evitando o construtor String(String) No BlackBerry Java Application, cada string citada é uma instância da classe java.lang.string. Crie uma String sem usar o construtor java.lang.string(string). Exemplo de código String str = "abc"; String str = "found " + n + " items"; Escrevendo loops eficientes Se houver a possibilidade de que o seu contêiner possua mais de um elemento, atribua o tamanho a uma variável local. Se a ordem de iteração entre os itens não for importante, você poderá fazer a iteração em ordem inversa para evitar a variável extra local na pilha e fazer a comparação de forma mais rápida. Exemplo de código int size = vector.size(); for( int i = 0; i < size; ++i ) {... } for( int i = vector.size() - 1; i >= 0; --i ) {... } Otimizando subexpressões Se você usar a mesma expressão duas vezes, use uma variável local. Exemplo de código int tmp = i+1; one( tmp ); two( tmp ); Otimizando as operações de divisão As operações de divisão podem ser lentas nos dispositivos BlackBerry porque o processador não tem uma instrução de divisão de hardware. 16

19 Práticas recomendadas para escrever de forma eficiente um BlackBerry Java Application Quando o código dividir um número positivo por dois, use shift right por um (>> 1). Use o shift right (>>) apenas quando você souber que está trabalhando com um valor positivo. Exemplo de código int = width >> 1; Evitando java.util.enumeration Evite usar java.util.enumeration a não ser que você queira ocultar dados (em outras palavras, para retornar uma enumeração dos dados em vez dos dados em si). Pedir um vetor ou tabela de hash para um objeto Enumeration é um processo lento e cria lixo desnecessário. Se outro thread puder modificar o vetor, sincronize a iteração. O Java SE usa um objeto Iterator para operações semelhantes, mas os objetos Iterator não estão disponíveis no Java ME. Exemplo de código for( int i = v.size() - 1; i >=0; --i ) { o = v.elementat( i );... } synchronized( v ) { for( int i = v.size() - 1; i >=0; --i ) { o = v.elementat( i );... } } Executando conversões com instanceof Use instanceof para avaliar se uma conversão foi bem-sucedida. Exemplo de código if( x instanceof String ) { (String)x.whatever(); } else {... } x Avaliando condições com instanceof Para gerar um código menor e mais rápido, ao avaliar uma condição usando instanceof, não faça uma avaliação explícita se as variáveis forem nulas. Exemplo de código if( e instanceof ExampleClass ) {... } if(! ( e instanceof ExampleClass ) ) {... } Evitando StringBuffer.append (StringBuffer) Para anexar um buffer de String a outro, o BlackBerry Java Application deve usar net.rim.device.api.util.stringutilities.append ( StringBuffer dst, StringBuffer src[, int offset, int length ] ). Exemplo de código 17

20 Práticas recomendadas para escrever de forma eficiente um BlackBerry Java Application public synchronized StringBuffer append(object obj) { if (obj instanceof StringBuffer) { StringBuffer sb = (StringBuffer)obj; net.rim.device.api.util.stringutilities.append ( this, sb, 0, sb ) return this; } return append(string.valueof(obj)); } Evitando retornar null Se você escrever um método público que retorne um objeto, o método deverá retornar null apenas mediante as seguintes condições: O aplicativo espera que ocorra um valor null durante a operação normal do aplicativo. O parâmetro do para o método especifica que null é um valor de retorno possível. Se o seu aplicativo não esperar um valor de retorno null, o método deverá acionar uma exceção apropriada, que force o chamador do método a lidar explicitamente com o problema. Talvez o chamador do método não precise verificar se há um valor de retorno null a não ser que ele acione uma exceção null. Evitando passar valores nulos para os métodos Não passe parâmetros nulos para um método de API a menos que a referência da API declare explicitamente que o método oferece suporte a eles. Cuidado ao passar null para um construtor Para evitar ambigüidade ao passar null para um construtor, converta null no valor apropriado. Se uma classe tiver dois ou mais construtores, passar um parâmetro null pode não identificar exclusivamente o construtor a ser usado. Conseqüentemente, o compilador reporta um erro. Convertendo null no objeto apropriado, você indica precisamente qual construtor o compilador deve usar. Essa prática também proporciona compatibilidade com versões posteriores de API que adicionarem novos construtores. Exemplo de código new someobject ((someobject)null ); Usando longs para identificadores exclusivos Use um long em vez de um String para constantes exclusivas, como GUIDs, chaves de tabela de hash e identificadores de estado ou contexto. Para que os identificadores permaneçam exclusivos em um BlackBerry Java Application, use as chaves geradas por um aplicativo com base em um hash de um identificador String. No Stringde entrada, inclua informações suficientes para torná-lo exclusivo. Por exemplo, use um nome de pacote totalmente qualificado como com.rim.samples.docs.helloworld. 18

21 Práticas recomendadas para escrever de forma eficiente um BlackBerry Java Application Saindo dos aplicativos corretamente Antes de invocar System.exit(int status), realize as limpezas necessárias, como a remoção de objetos do armazenamento em tempo de execução que os aplicativos não precisam mais. Imprimindo o rastreamento de pilha Ao depurar o aplicativo, para exibir o rastreamento de pilha, aplique o comando catch a uma instância exceção. Exemplo de código catch (Throwable t) { t.printstacktrace(); } Prática recomendada: Usando os objetos de forma criteriosa Para permitir que o BlackBerry Java Application use os recursos de memória de forma eficiente, considere as seguintes questões: De acordo com o tamanho do aplicativo, todos os objetos são necessários? Seu aplicativo pode armazenar objetos que representam primitivos como Long, Integer e Boolean como primitivos em vez de objetos? Todos os objetos persistentes são necessários? Existe alguma instância de vetor e tabela de hash? Essas instâncias são necessárias? Em caso positivo, quantos handles de objeto não são usados no vetor ou tabela de hash porque o tamanho inicial é maior do que o tamanho necessário? Quantos objetos seu aplicativo cria e depois descarta? Em outras palavras, quantos objetos específicos de escopo seu aplicativo cria? Prática recomendada: Reduzindo o tamanho do código compilado Para reduzir o tamanho do código compilado, considere as seguintes diretrizes: Defina o acesso apropriado. Evite criar interfaces. Use classes internas estáticas. Evite a inicialização de campos desnecessários. Importe classes individuais. 19

22 Práticas recomendadas para escrever de forma eficiente um BlackBerry Java Application Definindo o acesso apropriado Ao criar bibliotecas de código, você pode reduzir significativamente o tamanho do código compilado usando os modificadores de acesso apropriados para campos e métodos. Defina os campos como privados sempre que possível. Além de ser uma boa prática de codificação, isso permite que o compilador otimize o arquivo.cod. Quando possível, use o acesso padrão (package) em vez do acesso público (ou seja, omita as palavras-chave public e protected ). Evitando criar interfaces Ao criar bibliotecas de API, evite criar interfaces a menos que você preveja múltiplas implementações da API. As interfaces geram um código maior e mais lento. Usando classes internas estáticas Quando você usar uma classe interna para ocultar uma classe dentro de outra, mas a classe interna não fizer referência ao objeto da classe externa, defina a classe interna como estática. Isso impede a criação de uma referência à classe externa. Se você usar uma classe interna para escopo de nome, torne-a estática. Exemplo de código class outer { static class inner {... } } Evitando a inicialização de campos desnecessários Sempre que possível, permita que os campos sejam automaticamente inicializados como a seguir: referências a objetos são inicializadas como null int, byte ou long é inicializado como 0 Booleano é inicializado como false Você deve inicializar explicitamente as variáveis locais em um método. Exemplo de código class BetterExample { private int fieldscount; private Field _fieldwithfocus; private boolean _validlayout; private boolean _validlayout; } Importando classes individuais Um BlackBerry Java Application que use apenas uma pequena quantidade de classes de um pacote deve importar apenas as classes individuais. 20

23 Suporte a vários idiomas Exemplo de código import net.rim.blackberry.api.browser.browser; Suporte a vários idiomas O BlackBerry Integrated Development Environment inclui um mecanismo para criar recursos de string. A API de localização faz parte do pacote net.rim.device.api.i18n. Os aplicativos MIDP não oferecem suporte à localização. O BlackBerry Integrated Development Environment armazena recursos para uma localidade em um objeto ResourceBundle. Um objeto de ResourceBundleFamily contém uma coleta de ResourceBundles, que agrupa os recursos de um aplicativo. O aplicativo pode alternar entre idiomas, dependendo da localidade do usuário do dispositivo BlackBerry, sem precisar de novos pacotes de recursos. Você pode usar o BlackBerry Integrated Development Environment para compilar cada pacote de recursos em um arquivo.cod compilado separadamente. Você pode carregar os arquivos.cod apropriados nos dispositivos BlackBerry com os outros arquivos.cod para o aplicativo. Os recursos são organizados em uma hierarquia baseada na hereditariedade. Se uma string não for definida em uma localidade, será usada a string da localidade seguinte mais próxima. Prática recomendada: Armazenando strings de texto em arquivos de recursos Em vez de usar texto no código fonte, desenvolva aplicativos de forma que usem arquivos de recursos para localização (adaptados a regiões e idiomas específicos). Considere as seguintes diretrizes: Armazene as strings de texto para cada localidade em um único arquivo de recursos. No código fonte, use identificadores exclusivos para fazer uso dos arquivos de recursos apropriados. Desenvolva o aplicativo para que recupere dinamicamente o arquivo de recursos apropriado a ser exibido para o usuário do dispositivo BlackBerry com base em sua localidade. Suporte a multimídia Suporte a áudio Você pode criar um BlackBerry Java Application que funcione com os formatos de áudio suportados pelo dispositivo BlackBerry. O tipo de formato de áudio suportado por um dispositivo BlackBerry depende do número do modelo do dispositivo. Para obter mais informações sobre suporte a áudio em um dispositivo BlackBerry, visite 21

24 Suporte a multimídia Suporte a câmera Nos dispositivos BlackBerry com câmera, quando o usuário tira uma foto, o dispositivo a armazena no sistema de arquivos. O aplicativo do dispositivo BlackBerry pode acessar as fotos usando a API File Connection para Java ME que está disponível no BlackBerry Java Development Environment 4.2 ou posterior. O aplicativo do dispositivo BlackBerry pode chamar o aplicativo de câmera e escutar os eventos quando as imagens são adicionadas ao sistema de arquivos. Em um dispositivo BlackBerry com o BlackBerry Desktop Software 4.7 ou posterior, você pode permitir que um usuário do dispositivo BlackBerry envie uma imagem a um aplicativo do dispositivo BlackBerry. Se um usuário do dispositivo BlackBerry usa o aplicativo da câmera para tirar uma foto ou acessar uma imagem através do gerenciador de arquivos, o BlackBerry Device Software adiciona um item de menu ao aplicativo da câmera ou exibe uma caixa de diálogo no gerenciador de arquivos. Quando um usuário do dispositivo BlackBerry seleciona o item de menu ou a caixa de diálogo, o BlackBerry Device Software envia uma solicitação a um aplicativo do dispositivo BlackBerry que seja um manipulador de conteúdo para a imagem. O aplicativo do dispositivo BlackBerry pode aceitar a solicitação e abrir a imagem. Para que um aplicativo do dispositivo BlackBerry possa receber uma imagem, o aplicativo deve implementar a interface javax.microedition.content.contenthandler para registrar-se como um manipulador de conteúdo para um tipo de imagem tal como um. jpg. O registro como um manipulador de conteúdo associa o aplicativo do dispositivo BlackBerry ao tipo de imagem e permite que outros aplicativos do dispositivo BlackBerry enviem estes arquivos ao aplicativo do dispositivo BlackBerry. Para obter mais informações sobre como usar a Interface ContentHandler visite id=211. Suporte a vídeo Você pode criar um aplicativo do dispositivo BlackBerry que possa usar um objeto javax.microedition.media.player e sub-classes da classe javax.microedition.media.control para reproduzir um vídeo. O aplicativo do dispositivo BlackBerry chama um dos métodos net.rim.device.api.ui.manager.createplayer() para recuperar um objeto Player e recuperar um vídeo de fontes diferentes tal como um arquivo ou um fluxo. Um objeto Player permite que um usuário do dispositivo BlackBerry use o aplicativo como um Media Player e execute ações tais como jogar e pausar a reprodução de vídeo. O aplicativo do dispositivo BlackBerry chama o Player.realize() para permitir que o aplicativo recupere os recursos necessários, como o local de um arquivo de vídeo, para reproduzir um vídeo. O aplicativo do dispositivo BlackBerry chama Player.prefetch() para permitir que o aplicativo se prepare para reproduzir um vídeo. O aplicativo do dispositivo BlackBerry pode chamar o Player.getControls() para recuperar uma matriz de objetos Control que representam as operações ou funções que um Player suporta. Por exemplo, um objeto javax.microedition.media.control.volumecontrol permite que um aplicativo do dispositivo BlackBerry controle o volume utilizado para reproduzir um vídeo. Um objeto javax.microedition.media.control.videocontrol permite que um aplicativo do dispositivo BlackBerry controle a reprodução de um vídeo. 22

25 Suporte a multimídia Depois que o aplicativo do dispositivo BlackBerry recupera as informações sobre os objetos javax.microedition. media.control que suporta, o aplicativo pode chamar Player.getControl(), usando como um parâmetro uma String com o nome do controle, para recuperar um específico objeto Control. Por exemplo: VideoControl myvc = (VideoControl) Player.getControl("<VideoControl>"). O aplicativo do dispositivo BlackBerry pode definir as propriedades do objeto Control chamando os métodos do objeto Control. O aplicativo do dispositivo BlackBerry chama Player.start() para começar a reproduzir um vídeo e chama Player.close() para parar de reproduzir o vídeo. Você pode criar um aplicativo do dispositivo BlackBerry que use o localizador de imagem do aplicativo da câmera para gravar um vídeo em um arquivo.3gp ou em um fluxo de vídeo em um objeto java.io.bytearrayoutputstream. O aplicativo do dispositivo BlackBerry chama Manager.createPlayer("capture://video") para recuperar um objeto Player que suporte as interfaces VideoControl e RecordControl. O aplicativo do dispositivo BlackBerry chama Player.getControl("RecordControl") e converte o valor de retorno como um objeto RecordControl. Um objeto de RecordControl permite que um aplicativo do dispositivo BlackBerry controle a gravação de um vídeo. Chamar RecordControl.setRecordLocation ("file:///<nomedoarquivo>") define o local do arquivo.3gp. Chamar RecordControl.setRecordStream (ByteArrayOutputStream output) define o ByteArrayOutputStream ao qual transmitir. O aplicativo do dispositivo BlackBerry chama RecordControl.startRecord() seguido por Player.start() para começar a gravação de um vídeo. O aplicativo do dispositivo BlackBerry chama RecordControl.commit() seguido por Player.stop() para salvar o vídeo e parar a gravação. Você pode criar um aplicativo do dispositivo BlackBerry que reproduza um vídeo no BlackBerry Browser. O aplicativo do dispositivo BlackBerry chama net.rim.blackberry.api.browser.browser.getdefaultsession() para recuperar um objeto net.rim.blackberry.api. browser.browsersession. O objeto BrowserSession permite que o aplicativo do dispositivo BlackBerry interaja com o BlackBerry Browser. O aplicativo do dispositivo BlackBerry chama BrowserSession.displayPage() usando como parâmetro uma String com o formato "file:///<localdovídeo>", onde <localdovídeo> é o local do vídeo. BrowserSession.displayPage() exibe um vídeo no BlackBerry Browser. Você pode criar um aplicativo do dispositivo BlackBerry que reproduza um vídeo que requeira licenças de gerenciamento de direitos digitais. O aplicativo do dispositivo BlackBerry usa a classe net.rim.device.api. drm.drmmanager para instalar licenças DRM para um vídeo. Um dispositivo BlackBerry tem um objeto DRMManager. Chamar DRMManager.getLicenseChallenge (String contenturl, String[] permissions) recupera uma matriz de bytes que contém informações sobre as licenças DRM que o aplicativo do dispositivo BlackBerry deve obter e instalar para reproduzir um vídeo. Chamar DRMManager.installRights(String contenturl, byte[] rightsdata, DRMRightsInstallCallback callback) instala as licenças para um vídeo. Você pode permitir que um usuário do dispositivo BlackBerry envie um vídeo a um aplicativo do dispositivo BlackBerry. Para que o aplicativo do dispositivo BlackBerry receba e use o arquivo de vídeo, o aplicativo deve implementar a interface javax.microedition.content.contenthandler para registrar-se como um manipulador de conteúdo. Quando um usuário do dispositivo BlackBerry acessa um arquivo de vídeo através do aplicativo da câmera ou do gerenciador de arquivos, um item de menu é exibido, permitindo que o usuário do dispositivo BlackBerry envie o arquivo de vídeo a aplicativos do dispositivo BlackBerry que sejam manipuladores de conteúdo. 23

26 Projeto da interface do usuário e da navegação Projeto da interface do usuário e da navegação 3 Navegação e ação do usuário do dispositivo BlackBerry BlackBerry possuem um teclado, um trackwheel ou trackball, e uma tecla Escape para navegação e ação. A tecla Escape é um mecanismo fácil para retornar à tela anterior ou para limpar um menu ou uma caixa de diálogo da tela. O BlackBerry Java Application para dispositivos BlackBerry deve seguir o máximo possível os modelos de ação e navegação abaixo. Clicar no trackwheel ou trackball para invocar um menu. Pressionar a tecla Escape para voltar à tela anterior ou fechar o aplicativo na tela principal. Por padrão, os objetos de tela do BlackBerry fornecem essa funcionalidade sem necessidade de personalização; porém, é preciso adicionar itens de menu e lógica de interface do usuário e navegação adicional. Trackwheel e trackball Sensibilidade do trackball A sensibilidade do trackball refere-se à quantidade de movimento do trackball que é necessária para que o sistema identifique o movimento como um evento de navegação e para despachar um evento de navegação para a camada de software. O hardware do dispositivo BlackBerry mede o movimento físico do trackball usando unidades denominadas tiques. Quando o número de tiques ao longo de um eixo ultrapassa o limite do sistema ou um BlackBerry Java Application, um evento de navegação ao longo desse eixo é despachado para a camada de software e o sistema redefine a contagem de tiques para zero. As contagens de tiques também são redefinidas para zero após um determinado período de tempo inativo. Use a API do trackball para definir a sensibilidade do trackball. A alta sensibilidade do trackball equivale a um limite menor de tique, o que significa que são necessários pequenos movimentos do trackball para disparar eventos de navegação. Por outro lado, a baixa sensibilidade do trackball equivale a um limite maior de tique, o que significa que são necessários grandes movimentos do trackball para disparar eventos de navegação. Movimento do trackball Você pode usar a API do trackball para filtrar os dados de movimento do trackball que o hardware do dispositivo BlackBerry envia à camada de software. A API do trackball pode filtrar "ruídos" de movimento ou movimentos não desejados. 24

27 Criando uma interface de usuário que seja consistente com as interfaces padrão do BlackBerry Ela também pode ser usada para alterar configurações como aceleração do movimento do trackball. O aumento da configuração de aceleração de movimento do trackball pode fazer com que a camada de software identifique os movimentos do trackball como se estivessem com uma taxa mais rápida do que a taxa detectada pelo hardware do dispositivo BlackBerry, desde que o usuário continue rolando o trackball. A sensibilidade do trackball aumenta temporariamente enquanto o usuário rola o trackball sem pausa. Trackwheel Os dispositivos BlackBerry anteriores ao BlackBerry Pearl 8100 Series não possuem trackball. Em vez disso, possuem um trackwheel no lado direito do dispositivo. O trackwheel é o principal controle de navegação do usuário. Os usuários podem rolar o trackwheel para mover o cursor na vertical rolar o trackwheel enquanto pressionam a tecla Alt para mover o cursor na horizontal clicar no trackwheel para selecionar objetos ou abrir o menu Diretrizes Familiarize-se com os dois modelos de navegação, o trackwheel e o trackball, e verifique se o seu aplicativo funciona bem com ambos. Criando uma interface de usuário que seja consistente com as interfaces padrão do BlackBerry Você pode usar APIs MIDP padrão e APIs de interface de usuário do BlackBerry para criar interfaces do BlackBerry Java Application. As APIs de interface do usuário do BlackBerry são uma biblioteca de componentes de interface que oferecem layouts e comportamentos padrão consistentes com os principais aplicativos do dispositivo BlackBerry. Os componentes de tela fornecem um layout de tela padrão, um menu padrão e um comportamento padrão quando o usuário do dispositivo BlackBerry pressiona a tecla Escape ou clica no trackwheel ou trackball. Os componentes de campo fornecem elementos de interface padrão para escolha de datas e opções, caixas de seleção, listas, campos de texto, rótulos e controles da barra de andamento. Os gerentes de layout oferecem ao aplicativo a capacidade de organizar os componentes na tela de um dispositivo BlackBerry de maneiras padrão: na horizontal, na vertical ou da esquerda para a direita. Você pode usar as APIs de interface de usuário do BlackBerry para criar interfaces que incluam tabelas, grades e outros recursos especiais. O BlackBerry Java Development Environment usa um modelo de evento Java padrão para receber e responder a tipos específicos de eventos. Os aplicativos podem receber e responder a eventos de usuários de dispositivos BlackBerry, por exemplo, quando o usuário clica no trackwheel, clica no trackball ou digita no teclado, e a eventos do sistema como alertas globais, alterações em tempo real e conexões de porta USB. 25