Criando seu primeiro aplicativo

O BlackBerry® Java® Plug-in para Eclipse® 1.3 fornece modelos que podem ser usados para criar um projeto básico de aplicativo BlackBerry. Você pode personalizar o código no modelo para atender às suas necessidades ou pode criar um aplicativo do zero, usando um modelo vazio.

Para começar, nós criaremos uma versão do aplicativo "Hello World" usando o modelo Hello BlackBerry. Esta versão de "Hello World" é um aplicativo de UI básico que fornece alguns componentes simples de UI. O aplicativo inclui um campo de texto editável que permite que o usuário do smartphone BlackBerry digite texto em um campo; neste exemplo, ele pode digitar seu nome. O aplicativo também inclui um campo de botão. Quando o usuário do smartphone BlackBerry digita seu nome e clica no botão Say Hello to, o aplicativo exibe uma caixa de diálogo com o texto Hello <username>, conforme mostrado na seguinte captura de tela.

Esta tela mostra a UI de Hello BlackBerry.

Criar o aplicativo Hello BlackBerry

Antes de começar: No BlackBerry® Java® Plug-in para Eclipse®, certifique-se de ativar a perspectiva do BlackBerry Application Development. Clique em Window > Open Perspective > Other e depois escolhaBlackBerry Application Development.
  1. No menu BlackBerry, clique em New > BlackBerry Project.
  2. No campo Project name, digite HelloBlackBerry.
  3. Na caixa de diálogo Novo projeto BlackBerry, selecione Create new project in workspace.
  4. Em JRE, selecione Use a project specific JRE e, depois, escolha BlackBerry JRE 7.0.0 na lista suspensa.
  5. Clique em Next.
  6. Clique em Next.
  7. Selecione o modelo Hello BlackBerry.
  8. Clique em Finish.
Na lista de projetos no painel Explorador de pacotes, o projeto HelloBlackBerry é exibido. Você pode expandir o projeto para verificar se a pasta src/mypackage contém dois arquivos de origem Java®:
  • HelloBlackBerry.java: este arquivo contém o código de origem para a seção principal do aplicativo.
  • HelloBlackBerryScreen.java: este arquivo contém o código de origem para gerar a tela.

Execução do aplicativo

Você pode executar e testar seu aplicativo em um BlackBerry® Smartphone Simulator ou em um smartphone BlackBerry.

O BlackBerry® Java® Plug-in para Eclipse® inclui simuladores para vários modelos de smartphones BlackBerry. Os simuladores executam o mesmo código Java® que os smartphones, por isso um simulador fornece o ambiente exato para testar como seu aplicativo funcionará em um aparelho BlackBerry.

Executar seu aplicativo em um simulador

Nas etapas a seguir, usaremos o aplicativo Hello BlackBerry criado anteriormente para demonstrar como executar um aplicativo.
  1. No painel Package Explorer, selecione o projeto que deseja executar. Para este exemplo, selecione o projeto HelloBlackBerry.
  2. Para executar o aplicativo em um simulador, execute uma destas ações:
    • Clique com o botão direito do mouse no projeto e selecione Run As > BlackBerry Simulator.
    • Se você tiver habilitado a perspectiva do BlackBerry Application Development, na barra de ferramentas BlackBerry, clique no botão Run on BlackBerry Simulator.
    O BlackBerry® Java® Plug-in para Eclipse® constrói e compacta oo projeto e, em seguida, ativa o BlackBerry Smartphone Simulator.
  3. Na tela inicial do simulador, clique no ícone do aplicativo. Neste exemplo, clique no ícone Hello BlackBerry.
    Esta tela exibe o 9800 Simulator.
    O aplicativo Hello BlackBerry é aberto e exibe uma tela com um campo de texto editável e um botão.
  4. Para testar o aplicativo Hello BlackBerry, digite seu nome no campo Enter Name e clique no botão Say Hello to. Uma caixa de diálogo é exibida com o texto Hello <your name> e um botão OK. Clique em OK.
  5. Para fechar o aplicativo, no simulador, pressione a tecla Menu e selecione Close.
  6. Para fechar o simulador, clique em File > Exit.

Executar seu aplicativo em um smartphone

Antes de começar: Se o seu aplicativo usar APIs protegidas da Research In Motion®, primeiro você deverá obter chaves de assinatura de código da RIM. Para obter mais informações sobre assinatura e registro de código com a RIM para usar APIs protegidas, consulte www.blackberry.com/SignedKeys
  1. Conecte o smartphone BlackBerry® ao computador usando um cabo USB.
  2. No painel do Eclipse® Package Explorer, clique com o botão direito do mouse no projeto que deseja carregar no aparelho.
  3. Clique em BlackBerry> Load Project(s) on Device. O BlackBerry® Java® Plug-in para Eclipse® constrói e compacta o projeto. Se o smartphone for protegido por senha, será solicitado que você digite a senha. O aplicativo é carregado no aparelho.
  4. Na tela inicial do smartphone, clique no ícone para executar o aplicativo.
Próximo tópico: Apresentando o Java SDK

Estas informações foram úteis? Gostaríamos de receber seus comentários.