BlackBerry Messenger SDK

Transcrição

1 BlackBerry Messenger SDK Versão: 1.2 Getting Started Guide

2 Publicado: SWD

3 Conteúdo 1 Requisitos do sistema Dependências de versão do BlackBerry Messenger Ambiente de pré-produção BlackBerry Messenger Instalando e configurando os simuladores para que suportem o BlackBerry Messenger SDK... 5 Definir variáveis de ambiente Java... 5 Instalar e executar o BlackBerry MDS Simulator... 5 Configurar o BlackBerry MDS Simulator para usar criptografia de intensidade ilimitada... 6 Instale o pacote do BlackBerry Smartphone Simulator... 6 Configurando o BlackBerry Smartphone Simulator Configurando o ambiente de desenvolvimento... 8 Criar um projeto para o aplicativo conectado ao BlackBerry Messenger usando BlackBerry Java Plug-in para Eclipse... 8 Crie uma área de trabalho para o aplicativo conectado BlackBerry Messenger usando o BlackBerry Java Development Environment Executar o aplicativo conectado BlackBerry Messenger Executar o aplicativo usando os simuladores Execute o aplicativo do plug-in do BlackBerry Java para Eclipse Execute o aplicativo do BlackBerry Java Development Environment Enviar comentários... 13

4 Requisitos do sistema Requisitos do sistema 1 Java SE Development Kit (JDK), 32 bits, versão 6, atualização 20 ou posterior ( technetwork/java/javase/downloads/index.html) Nota: A plataforma do BlackBerry Messenger não suporta Java de 64 bits ou Java 7. Um dos seguintes ambientes de desenvolvimento: Plug-in do BlackBerry Java Plug-in para Eclipse (na.blackberry.com/developers/javaappdev/javaplugin.jsp) que inclui o BlackBerry Java SDK 6.0 BlackBerry Java Development Environment 6.0 (na.blackberry.com/eng/developers/javaappdev/ javadevenv.jsp) 2

5 Dependências de versão do BlackBerry Messenger Dependências de versão do BlackBerry Messenger 2 A tabela a seguir mostra as dependências entre as versões do BlackBerry Messenger SDK, BlackBerry Messenger e BlackBerry Device Software. É possível usar esta tabela para determinar a versão mínima do BBM e BlackBerry Device Software necessária para executar o aplicativo. Versão do BBM SDK Versão do BBM Versão do BlackBerry Device Software e posterior e posterior 3

6 Ambiente de pré-produção BlackBerry Messenger Ambiente de pré-produção BlackBerry Messenger O ambiente de pré-produção BBM é um ambiente de desenvolvimento que você pode usar para construir seu aplicativo conectado ao BBM e testá-lo com uma comunidade beta pequena antes de lançá-lo na loja on-line BlackBerry App World. Se o seu aplicativo ainda não existe no BlackBerry App World, ele é automaticamente colocado no ambiente de pré-produção. O ambiente de pré-produção fornece toda a funcionalidade do ambiente de produção, com as seguintes limitações: As licenças de teste são limitadas a 100 por aplicativo Os aplicativos expiram depois de 180 dias Um aplicativo em pré-produção não pode se comunicar com o mesmo aplicativo registrado com o BlackBerry App World 3 4

7 Instalando e configurando os simuladores para que suportem o BlackBerry Messenger SDK Instalando e configurando os simuladores para que suportem o BlackBerry Messenger SDK 4 Para testar o aplicativo conectado ao BBM, é necessário instalar e configurar o BlackBerry MDS Simulator e o BlackBerry Smartphone Simulator com configurações que permitem a comunicação entre o BlackBerry MDS Simulator e duas instâncias do BlackBerry Smartphone Simulator. Definir variáveis de ambiente Java Antes de começar: Verifique se você está executando a versão de 32 bits do Java SE Development Kit (JDK). 1. No Windows, abra a caixa de diálogo Environment Variables. 2. Defina a variável do ambiente JAVA_HOME para o diretório em que o JDK foi instalado, por exemplo: C:\Program Files\Java\jdk1.6.0_24. No Windows de 64 bits, o caminho padrão é C:\Program Files(x86)\Java\jdk1.6.0_ Na variável do ambiente PATH, adicione %JAVA_HOME%\bin; no começo da string. 4. Clique em OK para salvar e fechar a caixa de diálogo Environment Variables. 5. Verifique se as variáveis do ambiente estão definidas corretamente. a. Abra um prompt de comando. b. Digite java -version e verifique se a versão Java é a mesma versão definida na variável do ambiente: java version "1.6.0_24" Java(TM) SE Runtime Environment (build 1.6.0_24-b07) Java HotSpot(TM) Client VM (build 19.1-b02, mixed mode, sharing) Instalar e executar o BlackBerry MDS Simulator Antes de começar: Executar a tarefa, Configurar o BlackBerry MDS Simulator para usar criptografia de intensidade ilimitada. 1. Na pasta onde você extraiu o arquivo BlackBerry Messenger SDK, abra a pasta MDS simulator. 2. Extraia o conteúdo do arquivo MDSv3.5.3.zip. 3. Abra a pasta sdk > mds. 4. Clique duas vezes em run.bat para iniciar o BlackBerry MDS Simulator. Quando terminar: Se você executar o BlackBerry MDS Simulator e o BlackBerry Smartphone Simulator em computadores separados, no arquivo rimpublic.property (localizado, por padrão em C:\Program Files\Research In Motion\BlackBerry JDE 6.0.0\MDS\config), altere o valor UDP.send.host para o endereço IP do computador executando o BlackBerry MDS Simulator. 5

8 Instale o pacote do BlackBerry Smartphone Simulator Configurar o BlackBerry MDS Simulator para usar criptografia de intensidade ilimitada Nota: Você precisa residir em um país elegível para habilitar esta funcionalidade. Antes de começar: Verifique se você está executando a versão de 32 bits do Java SE Development Kit (JDK). 1. Faça download do arquivo jce_policy-6.zip do site da Oracle site em java/javase/downloads/jce-6-download html. 2. Extraia o conteúdo do arquivo jce_policy-6.zip para seu computador. 3. No diretório do sistema JDK (por exemplo, C:\Program Files\Java\jre1.6.0_24\jre\lib\security), substitua os arquivos local_policy.jar e US_export_policy.jar na pasta de segurança. Para obter mais informações, consulte Definir variáveis de ambiente Java. Instale o pacote do BlackBerry Smartphone Simulator 1. Na pasta em que você extraiu o arquivo BlackBerry Messenger SDK, abra a pasta BlackBerry smartphone simulator. 2. Clique duas vezes no arquivo BlackBerry_Simulators_<version>_<model>.exe. 3. Siga as instruções exibidas na tela. Depois de concluída a instalação do pacote BlackBerry Smartphone Simulator, dois arquivos.bat, sim1.bat e sim2.bat estarão disponíveis na pasta em que o BlackBerry Smartphone Simulator foi instalado. Esses arquivos.bat iniciam duas instâncias do BlackBerry Smartphone Simulator. Essas instâncias comunicam-se entre si pela plataforma BlackBerry Messenger usando o BlackBerry MDS Simulator em execução no mesmo computador. Para aprender a executar as instâncias do BlackBerry Smartphone Simulator e o BlackBerry MDS Simulator em computadores diferentes, consulte Configurando o BlackBerry Smartphone Simulator. Configurando o BlackBerry Smartphone Simulator Se você quiser executar o BlackBerry Smartphone Simulator sem iniciar os dois arquivos.bat no arquivo.zip do BlackBerry Messenger SDK, poderá criar seus próprios arquivos.bat especificando os seguintes parâmetros para oferecer suporte ao BlackBerry Messenger SDK. Parâmetro app-param=regdestip app-param=regdestport Descrição Este parâmetro deve especificar o endereço IP do computador que executa o BlackBerry MDS Simulator. Se o BlackBerry MDS Simulator estiver sendo executado no mesmo computador que o BlackBerry Smartphone Simulator, especifique Este parâmetro deve especificar a porta padrão, Se você usar um valor diferente, certifique-se de que seja o mesmo para todas as instâncias de BlackBerry Smartphone Simulator. 6

9 Instale o pacote do BlackBerry Smartphone Simulator Parâmetro appparam=disablesyncservicerecord session app-param=regsrcport pin Descrição Este parâmetro deve ser especificado para possibilitar a comunição entre PINs entre os aparelhos. Se você executou o BlackBerry Smartphone Simulator sem ter especificado este parâmetro, em BlackBerry JDE, clique em File > Erase Simulator File > Erase Filesystem para excluir o sistema de arquivos e remova o registro de serviço SINC da instância anterior. O número da sessão deve ser exclusivo para cada instância do simulador. O número da porta deve ser exclusivo para cada instância do simulador. Esse parâmetro deve ser 0x ou superior e exclusivo para cada instância do simulador. Exemplo O exemplo a seguir demonstra como executar duas instâncias de BlackBerry Smartphone Simulator usando a mesma instância de BlackBerry MDS Simulator. Crie um arquivo.bat para iniciar cada instância personalizada de BlackBerry Smartphone Simulator com os seguintes conteúdos: Exemplo de conteúdo do arquivo.bat do simulador off fledge.exe /app=jvm.dll /handheld=9800 /session=sim1 /app-param=jvmalxconfigfile: 9800.xml /data-port=0x4d44 /data-port=0x4d4e /pin=0x a /app-param=regversion=3 / app-param=regdestip= /app-param=regdestport=19781 /appparam=regsrcport=19780 /app-param=disablesyncservicerecord Exemplo de conteúdo do arquivo.bat do simulador off fledge.exe /app=jvm.dll /handheld=9800 /session=sim2 /app-param=jvmalxconfigfile: 9800.xml /data-port=0x4d44 /data-port=0x4d4e /pin=0x b /app-param=regversion=3 / app-param=regdestip= /app-param=regdestport=19781 /appparam=regsrcport=19782 /app-param=disablesyncservicerecord 7

10 Configurando o ambiente de desenvolvimento Configurando o ambiente de desenvolvimento 5 Tanto o BlackBerry Java Development Environment quanto o BlackBerry Java Plug-in para Eclipse oferecem suporte ao desenvolvimento de aplicativos habilitados para a plataforma BlackBerry Messenger. Criar um projeto para o aplicativo conectado ao BlackBerry Messenger usando BlackBerry Java Plug-in para Eclipse 1. Em Eclipse, abra o BlackBerry Application Development perspective. 2. Clique em File > New > BlackBerry Project. 3. Na caixa de diálogo New BlackBerry Project, no campo Project Name, digite um nome para seu projeto. 4. Na seção JRE, selecione um BlackBerry JRE versão 5.0 ou posterior e clique em Finish. 5. Na Package Explorer visualização, clique com o botão direito do mouse no projeto e clique em Properties. 6. Na caixa de diálogo Properties, no painel esquerdo, clique em Java Build Path. 7. Clique na guia Libraries. 8. Clique no botão Add External JARs. 9. Navegue até a pasta da qual o arquivo BlackBerry Messenger SDK foi extraído. Na pasta BBM SDK, clique duas vezes em net_rim_bb_qm_platform.jar. 10. Clique em Next. 11. Na janela de propriedades, clique em OK. 12. Quando estiver pronto para desenvolver seu projeto, no menu Project, clique em BlackBerry > Package All. Quando terminar: Para testar seu aplicativo, consulte Executar o aplicativo conectado BlackBerry Messenger. Crie uma área de trabalho para o aplicativo conectado BlackBerry Messenger usando o BlackBerry Java Development Environment Antes de começar: Na pasta da qual o BlackBerry Messenger SDK foi extraído, copie net_rim_bb_qm_platform.jar da pasta BBM SDK para a pasta lib do BlackBerry Java Development Environment (a localização padrão da pasta lib é C:\Program Files\Research In Motion\BlackBerry JDE 6.0.0\lib). 1. Em BlackBerry JDE, clique em File > New Workspace. 2. No campo Workspace Name, digite um nome para a área de trabalho e clique em OK. 3. Clique com o botão direito do mouse na área de trabalho e clique em Properties. 4. Na caixa de diálogo Workspace Properties, na guia General, ao lado da lista Imported Jar Files, clique em Add. 8

11 Crie uma área de trabalho para o aplicativo conectado BlackBerry Messenger usando o BlackBerry Java Development Environment 5. Na caixa de diálogo Add file, navegue até C:\Program Files\Research In Motion\BlackBerry JDE 6.0.0\lib e clique duas vezes em no arquivo net_rim_bb_qm_platform.jar. O arquivo aparece na lista Arquivos JAR importados, nas propriedades da área de trabalho. Agora você pode importar as classes do BlackBerry Messenger e compilar seu aplicativo. 6. Clique com o botão direito do mouse na área de trabalho e execute uma das seguintes ações: Para importar um projeto, clique em Add Project to <workspace name>. Para criar um novo projeto, clique em Create new Project in <workspace name>. 7. Quando você estiver pronto para criar seu projeto, clique na lista suspensa do perfil BlackBerry Smartphone Simulator localizada no canto superior direito do BlackBerry JDE. Por padrão, o perfil selecionado é Default Simulator. 8. Na lista suspensa, clique em No menu Build, clique em Build. Os arquivos.cod do seu aplicativo são criados e colocados no diretório de simuladores do BlackBerry JDE. Quando terminar: Para testar seu aplicativo, consulte Executar o aplicativo conectado BlackBerry Messenger. 9

12 Executar o aplicativo conectado BlackBerry Messenger Executar o aplicativo conectado BlackBerry Messenger 6 Executar o aplicativo usando os simuladores 1. Na pasta em que você extraiu o arquivo.zip contendo BlackBerry Messenger SDK, abra a pasta MDS Simulator -> sdk -> mds. 2. Clique duas vezes em run.bat para iniciar o BlackBerry MDS Simulator. 3. No Windows Explorer, navegue até a pasta em que você instalou o BlackBerry Smartphone Simulator. Por padrão, a localização desta pasta é C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0\ (9800). 4. Clique duas vezes no arquivo sim1.bat (ou em seu arquivo.bat personalizado) a fim de iniciar um BlackBerry Smartphone Simulator com as configurações apropriadas para executar seu aplicativo e se comunicar com o BlackBerry MDS Simulator. 5. No Windows Explorer, na pasta BlackBerry Smartphone Simulator, clique duas vezes no arquivo sim2.bat (ou em seu segundo arquivo.bat personalizado) para iniciar uma segunda instância de BlackBerry Smartphone Simulator com as configurações apropriadas para se comunicar com o primeiro BlackBerry Smartphone Simulator. 6. Para que cada instância de BlackBerry Messenger tenha as demais instâncias como contatos, na primeira instância de BlackBerry Smartphone Simulator, abra BlackBerry Messenger. 7. Clique na tecla Menu e clique em no item de menu Invite Contact. 8. Clique em Invite by sending a PIN or message. 9. No campo To, digite B. Este é o PIN padrão da segunda instância de BlackBerry Smartphone Simulator. 10. Na segunda instância de BlackBerry Smartphone Simulator, abra BlackBerry Messenger e aceite o convite. 11. Clique na Send tecla. 12. Na primeira instância de BlackBerry Smartphone Simulator, feche BlackBerry Messenger. 13. Na tela inicial, clique no ícone do aplicativo da plataforma BlackBerry Messenger. Agora você pode se comunicar entre as duas instâncias de BlackBerry Smartphone Simulator. Execute o aplicativo do plug-in do BlackBerry Java para Eclipse 1. Clique em Run > Debug Configurations. 2. Crie uma nova configuração de lançamento do BlackBerry e digite um nome. 3. Na guia Projects, selecione os projetos que deseja lançar. 4. Na guia Simulator, clique em General. 5. Na lista suspensa Device, selecione um simulador (por exemplo: SimPackage _ ). 10

13 Execute o aplicativo do BlackBerry Java Development Environment Para aprender como instalar o pacote do simulador, consulteinstale o pacote do BlackBerry Smartphone Simulator. 6. Clique na guia Advanced: a. Marque a caixa de seleção Use Customized command options. b. Na caixa Customized command line, digite os argumentos do arquivo sim1.bat. Por exemplo, "C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\ (9800)\fledge.exe" /handheld=9800 /app-param=jvmalxconfigfile: 9800.xml /pin=0x a /data-port=0x4d44 /data-port=0x4d4e /session=9800 / app="c:\program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\ (9800)\Jvm.dll" /app=jvm.dll /handheld=9800 /session=sim1 /appparam=jvmalxconfigfile:9800.xml /data-port=0x4d44 /data-port=0x4d4e / pin=0x a /app-param=regversion=3 /app-param=regdestip= /appparam=regdestport=19781 /app-param=regsrcport=19780 /appparam=disablesyncservicerecord /title="blackberry Simulator" c. Na caixa Customized working directory, digite o caminho do diretório em que o pacote do simulador foi instalado. d. Na caixa Customized MDS directory, digite o caminho do diretório em que o pacote do simulador MDS foi instalado. Para aprender como instalar o pacote do simulador MDS, consulteinstalar e executar o BlackBerry MDS Simulator. 7. Para salvar as configurações, clique em Apply. 8. Clique em Debug. Execute o aplicativo do BlackBerry Java Development Environment 1. No BlackBerry JDE, clique em Edit > Preferences. 2. Crie um novo Perfil de simulador e digite um nome. 3. Na guia Simulator, clique em General. 4. Na lista suspensa Device, selecione um simulador (por exemplo: SimPackage _ ). 5. Clique na guia Advanced: a. Marque a caixa de seleção Use Customized command options. b. Na caixa Customized command line, digite os argumentos do arquivo sim1.bat. Por exemplo: "C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\ (9800)\fledge.exe" /handheld=9800 /app-param=jvmalxconfigfile: 9800.xml /pin=0x a /data-port=0x4d44 /data-port=0x4d4e /session=9800 / app="c:\program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\ (9800)\Jvm.dll" /app=jvm.dll /handheld=9800 /session=sim1 /appparam=jvmalxconfigfile:9800.xml /data-port=0x4d44 /data-port=0x4d4e / 11

14 Execute o aplicativo do BlackBerry Java Development Environment pin=0x a /app-param=regversion=3 /app-param=regdestip= /appparam=regdestport=19781 /app-param=regsrcport=19780 /appparam=disablesyncservicerecord /title="blackberry Simulator" c. Na caixa Customized working directory, digite o caminho do diretório em que o pacote do simulador foi instalado. d. Na caixa Customized MDS directory, digite o caminho do diretório em que o pacote do simulador foi instalado. 6. Clique em OK. 7. Clique em Run. 12

15 Enviar comentários Enviar comentários 7 Para enviar comentários sobre este material, visite 13