Création de votre première application

BlackBerry® Java® Plug-in pour Eclipse® 1.3 fournit des modèles à utiliser pour créer un projet d'application BlackBerry de base. Vous pouvez personnaliser le code du modèle pour l'adapter à vos besoins ou créer une application de toutes pièces à partir d'un modèle vide.

Pour commencer, nous allons créer une version de l'application « Hello World » à l'aide du modèle Hello BlackBerry. Cette version de « Hello World » est une application avec interface utilisateur de base qui fournit des composants d'interface utilisateur simples. L'application inclut un champ de texte modifiable qui permet à l'utilisateur de smartphone de saisir du texte ; dans cet exemple, l'utilisateur peut taper son nom. L'application inclut également un champ avec bouton. Lorsque l'utilisateur de smartphone tape son nom et clique sur le bouton Say Hello to (Dire bonjour à), l'application affiche une boîte de dialogue indiquant Hello <username> (Bonjour <nom indiqué>), comme sur la capture d'écran suivante.

Cet écran illustre l'interface utilisateur Hello BlackBerry.

Créer l'application Hello BlackBerry

Avant de commencer : Dans le plug-in BlackBerry® Java® Plug-in pour Eclipse®, assurez-vous d'activer la perspective de développement d'application BlackBerry. Cliquez sur Window (Fenêtre) > Open Perspective (Ouvrir la perspective) > Other (Autre), puis choisissez BlackBerry Application Development (Développement d'application BlackBerry).
  1. À partir du menu BlackBerry, cliquez sur New (Nouveau) > BlackBerry Project (Projet BlackBerry).
  2. Dans le champ Project name (Nom du projet), saisissez HelloBlackBerry.
  3. Dans la boîte de dialogue Nouveau projet BlackBerry, sélectionnez Create new project in workspace (Créer un projet dans un espace de travail).
  4. Sous JRE, sélectionnez Use a project specific JRE (Utiliser un JRE spécifique au projet) puis choisissez BlackBerry JRE 7.0.0 dans la liste déroulante.
  5. Cliquez sur Next. (Suivant).
  6. Cliquez sur Next. (Suivant).
  7. Sélectionnez le modèle Hello BlackBerry.
  8. Cliquez sur Finish. (Terminer).
Dans la liste de projets sur le volet de l'explorateur de progiciels, le projet HelloBlackBerry apparaît. Vous pouvez développer le projet et voir que le dossier src/mypackage contient deux fichiers source Java® :
  • HelloBlackBerry.java : contient le code source de la section principale de l'application.
  • HelloBlackBerryScreen.java : contient le code source de création de l'écran.

Exécution de votre application

Vous pouvez exécuter et tester votre application à l'aide de BlackBerry® Smartphone Simulator ou d'un smartphone BlackBerry.

Le plug-in BlackBerry® Java® Plug-in pour Eclipse® inclut des simulateurs pour différents modèles de smartphones BlackBerry. Les simulateurs exécutent le même code Java® que les smartphones. Par conséquent, un simulateur fournit un environnement précis permettant de tester la façon dont votre application se comporte sur un terminal BlackBerry.

Exécuter votre application dans un simulateur

Dans les étapes suivantes, nous utilisons l'application Hello BlackBerry créée plus tôt pour montrer comment exécuter une application.
  1. Dans le volet Package Explorer (Explorateur de progiciels), sélectionnez le projet que vous voulez exécuter. Pour cet exemple, sélectionnez le projet HelloBlackBerry.
  2. Pour exécuter l'application dans un simulateur, effectuez l'une des actions suivantes :
    • Cliquez avec le bouton droit sur le projet, puis sélectionnez Run As (Exécuter en tant que) > BlackBerry Simulator (Simulateur BlackBerry).
    • Si vous avez activé la perspective de développement d'applications BlackBerry, depuis la barre d'outils BlackBerry, cliquez sur le bouton Run on BlackBerry Simulator (Exécuter dans BlackBerry Simulator).
    BlackBerry® Java® Plug-in pour Eclipse® produit et compile le projet, puis lance BlackBerry Smartphone Simulator.
  3. Sur l'écran d'accueil du simulateur, cliquez sur l'icône de l'application. Dans cet exemple, cliquez sur l'icône Hello BlackBerry.
    Cet écran montre le simulateur 9800.
    L'application HelloBlackBerry s'ouvre et affiche un écran avec un champ textuel modifiable et un bouton.
  4. Pour tester l'application Hello BlackBerry, tapez votre nom dans le champ Enter Name (Entrer le nom), puis cliquez sur le bouton Say Hello to (Dire bonjour à). Une boîte de dialogue s'affiche avec le texte Hello <your name> (votre nom) et un bouton OK. Cliquez sur OK.
  5. Pour fermer l'application, sur le simulateur, appuyez sur la touche Menu, puis sélectionnez Close (Fermer).
  6. Pour fermer le simulateur, cliquez sur File (Fichier) > Exit. (Quitter).

Exécuter votre application sur un smartphone

Avant de commencer : Si votre application utilise des API Research In Motion® protégées, vous devez d'abord obtenir des clés de signature de code auprès de RIM. Pour plus d'informations à propos de la signature du code et de l'enregistrement auprès de RIM pour utiliser des API protégées, rendez-vous à l'adresse www.blackberry.com/SignedKeys.
  1. Connectez le smartphone BlackBerry® à votre ordinateur avec un câble USB.
  2. Dans le volet Package Explorer Eclipse®, cliquez avec le bouton droit sur le projet à charger sur le terminal.
  3. Cliquez sur BlackBerry > Load Project(s) on Device (Charger le projet sur le terminal). Le plug-in BlackBerry® Java® Plug-in pour Eclipse® produit et compile le projet. Si le smartphone est protégé par un mot de passe, vous êtes invité à le saisir. L'application est chargée sur le terminal.
  4. Sur l'écran d'accueil du smartphone, cliquez sur l'icône de l'application pour exécuter cette dernière.

Plus de didacticiels

Voici quelques-uns des didacticiels les plus avancés :

Sujet précédent: Clés de signature de code

Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.