BlackBerry Messenger SDK
Versão: 1.2
Publicado: 2011-10-11 SWD-1391821-1011103456-012
Conteúdo
1 Requisitos do sistema... 2
2 Dependências de versão do BlackBerry Messenger... 3
3 Ambiente de pré-produção BlackBerry Messenger... 4
4 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... 6
5 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... 8
6 Executar o aplicativo conectado BlackBerry Messenger... 10
Executar o aplicativo usando os simuladores... 10
Execute o aplicativo do plug-in do BlackBerry Java para Eclipse... 10
Execute o aplicativo do BlackBerry Java Development Environment... 11
Requisitos do sistema
1
• Java® SE Development Kit (JDK), 32 bits, versão 6, atualização 20 ou posterior (http://www.oracle.com/ 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)
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
1.0 6.0.0 5.0 e posterior 1.2 6.0.1 5.0 e posterior
Getting Started Guide Dependências de versão do BlackBerry Messenger
Ambiente de pré-produção BlackBerry
Messenger
3
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
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_24. 3. 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.
Getting Started Guide Instalando e configurando os simuladores para que suportem o BlackBerry Messenger SDK
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 http://www.oracle.com/technetwork/
java/javase/downloads/jce-6-download-429243.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 Descrição
app-param=regDestIP 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 127.0.0.1.
app-param=regDestPort Este parâmetro deve especificar a porta padrão, 19781. Se você usar um valor diferente, certifique-se de que seja o mesmo para todas as instâncias de BlackBerry Smartphone Simulator.
Parâmetro Descrição
app-param=DisableSyncServiceRecord
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.
session O número da sessão deve ser exclusivo para cada instância do simulador.
app-param=regSrcPort O número da porta deve ser exclusivo para cada instância do simulador.
pin Esse parâmetro deve ser 0x2100000 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 1:
@echo off
fledge.exe /app=Jvm.dll /handheld=9800 /session=Sim1 /app-param=JvmAlxConfigFile: 9800.xml /data-port=0x4d44 /data-port=0x4d4e /pin=0x2100000A /app-param=regVersion=3 / app-param=regDestIP=127.0.0.1 param=regDestPort=19781
/app-param=regSrcPort=19780 /app-param=DisableSyncServiceRecord
Exemplo de conteúdo do arquivo .bat do simulador 2:
@echo off
fledge.exe /app=Jvm.dll /handheld=9800 /session=Sim2 /app-param=JvmAlxConfigFile: 9800.xml /data-port=0x4d44 /data-port=0x4d4e /pin=0x2100000B /app-param=regVersion=3 / app-param=regDestIP=127.0.0.1 param=regDestPort=19781
/app-param=regSrcPort=19782 /app-param=DisableSyncServiceRecord
Getting Started Guide Instale o pacote do BlackBerry Smartphone Simulator
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.
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 9800-6.0.0.313. 9. 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.
Getting Started Guide Crie uma área de trabalho para o aplicativo conectado BlackBerry Messenger usando o BlackBerry Java Development Environment
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\6.0.0.313 (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 email message.
9. No campo To, digite 2100000B. 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-6.0.0.313_9800-9800).
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\6.0.0.313 (9800)\fledge.exe" /handheld=9800 /app-param=JvmAlxConfigFile: 9800.xml /pin=0x2100000A /data-port=0x4d44 /data-port=0x4d4e /session=9800 / app="C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\6.0.0.313 (9800)\Jvm.dll" /app=Jvm.dll /handheld=9800 /session=Sim1 /app-param=JvmAlxConfigFile:9800.xml /data-port=0x4d44 /data-port=0x4d4e /
pin=0x2100000A param=regVersion=3 param=regDestIP=127.0.0.1 param=regDestPort=19781 param=regSrcPort=19780
/app-param=DisableSyncServiceRecord /title="BlackBerry 9800-1 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-6.0.0.313_9800-9800). 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\6.0.0.313 (9800)\fledge.exe" /handheld=9800 /app-param=JvmAlxConfigFile: 9800.xml /pin=0x2100000A /data-port=0x4d44 /data-port=0x4d4e /session=9800 / app="C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\6.0.0.313 (9800)\Jvm.dll" /app=Jvm.dll /handheld=9800 /session=Sim1 /app-param=JvmAlxConfigFile:9800.xml /data-port=0x4d44 /data-port=0x4d4e /
Getting Started Guide Execute o aplicativo do BlackBerry Java Development Environment
pin=0x2100000A param=regVersion=3 param=regDestIP=127.0.0.1 param=regDestPort=19781 param=regSrcPort=19780
/app-param=DisableSyncServiceRecord /title="BlackBerry 9800-1 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.
Enviar comentários
7
Para enviar comentários sobre este material, visite www.blackberry.com/docsfeedback.
Getting Started Guide Enviar comentários
