Apache Adobe Flex TutorialTutoriaux Adobe Flex & AIR en Français

Adobe Cocomo – Installer le SDK Adobe Cocomo

Dans ce tutorial, je vais présenter les différentes étapes pour l'installation du SDK Adobe Cocomo. Une fois ce SDK installé, et votre environnement de travail configuré, vous pourrez commencer à développer des applications Flex avec le framework Cocomo.

Voici les grandes étapes de la configuration de votre environnement de travail:

1. S'enregistrer sur le portail développeur Adobe
2. Créer une "room" (salon)
3. Télécharger le SDK
4. Générer une Shared Secret Key
5. Configurer votre environnement de développement

 S'enregistrer sur le portail développeur Adobe

Le portail développeur Adobe (Developer Portal) permet aux développeurs de suivre leur compte et l'utilisation de leurs rooms, de créer de nouvelles rooms, de générer une clé partagée (Shared Secret Key) entre autres. Vous allez devoir créer un compte développeur. Un compte développeur est simplement un compte unique qui peut être utilisé dans l'URL de votre room. Il doit être unique et il sera directement concaténé à l'URL de votre room principale. Essayez-donc de trouver quelque chose de simple respectant les caractères standard URL.

Pour vous enregistrer:

1. Rendez-vous sur le Developer Portal.
2. Si vous avez déjà un compte développeur associé avec votre Adobe ID, entrez votre Adobe ID. Si vous avez déjà téléchargé des versions d'évaluation et autres depuis le site d'Adobe, vous devriez déjà disposer d'un Adobe ID. Si vous n'avez pas de compte développeur, allez à l'étape 5
3. Choisissez "Remember Me" pour stocker un cookie qui va sauvegarder vos informations de connexion
4. Choisissez "Login"
5. Si vous n'avez pas de compte développeur, choisissez "New Dev? Sign Up!"
6. Une fois votre compte développeur crée, vous serez automatiquement redirigé vers le Developer Portal.

Créer une Room

Une Room est le nom sous Cocomo représentant un lieu virtuel sur le service Acrobat.com. Ces rooms sont représentées dans votre application par une URL.  Les Rooms sont comme des points de rencontre à une URL. Bien que vous puissiez créer des rooms avec du code ou via la Console Developer, le Developer Portal permet de le faire facilement. Créez une room pour pouvoir utiliser les exemples du SDK et tester votre code.

Pour créer une room:

1. Une fois loggé dans le Developer Portal, Allez dans le panel Room Instances (en haut à droite)
2. Cliquez sur Add
3. Donnez un nom à votre room (qui sera concaténé à votre URL de room)
4. Cliquez sur Save

Une room basée sur le template par défaut (une room vide) sera automatiquement créée.

 Télécharger le SDK

Avant de pouvoir tester les exemples, il va vous falloir installer le SDK depuis le portail développeur:

1. Loggez vous sur le Developer Portal
2. Cliquez sur le bouton "Download the SDK" en  haut à droite
3. Dézippez le SDK où vous le souhaitez

Générer une clé secrète (Shared Secret Key)

Une Shared Secret Key est seulement nécessaire quand vous êtes prêt à déployer un application qui utilise une authentification externe. Depuis le Developer Portal, vous pouvez générer une SSK (ou en créer une nouvelle si l'existante a été compromise). Pendant les phases de développement et de test, les utilisateurs entrent soit comme invités (guest) avec simplement un username, soit avec un utilisateur complet (nom d'utilisateur et password). Cocomo ne comprend que les passwords Adobe ID, donc quand quelqu'un entre un unsername et un password, les deux doivent appartenir au système Adobe ID.

Cependant, lors du déploiement, bien que certains développeurs vont créer des applications qui accepterons que des invités (seulement un username), la plupart des applications vont utiliser une authentification. La SSK est faîte pour cela. Ainsi, Adobe ne connaîtra pas les mot des passe de vos utilisateurs et vous pourrez créer et gérer une authentification en utilisant vos propres outils et infrastructure (par exemple vos bases de données et des serveurs LDAP).

Grâce aux scripts d'authentification externes fournit avec Cocomo, la SSK va vous permettre de prendre un couple username/password, de l'authentifier sur votre propre système, et de le passer à votre application client.

Si vous avez une clé existante, la création d'une nouvelle clé remplace l'ancienne clé. Seulement une clé est disponible pour chaque utilisateur avec un compte développeur, ce qui signifie que chaque compte est associé avec une clé. Votre clé est affichée dans la partie "Account Information" du Developer Portal.

Pour générer une clé, cliquez simplement sur Generate puis acceptez le message de confirmation.

Configurer votre environnement de développement

Avant de configurer votre environnement de développement, assurez vous que vous avez bien un compte développeur et que vous avez téléchargé le SDK. Vous devrez aussi avoir installé Flex Builder 3.

Attention, Adobe Cocomo n'est pas supporté par Flex Builder 2.

Ajouter le SDK comme un plug-in Flex Builder

Le SDK peut facilement être installé comme un plug-in Flex Builder. Pour la version beta de Cocomo, vous ne pouvez accéder au contenu du SDK que par Flex Builder. Cela va vous permettre d'accéder facilement à la doc de l'API et d'autres ressources par le menu Help. D'autres fonctionalités seront ajoutées dans les prochaines version de Cocomo.

Pour installer le SDK dans Flex Builder:

• Dézippez puis copiez le SDK dans le dossier "plugins" de Flex Builder. Par exemple:
  • Windows: C:\Program Files\Adobe\Flex Builder 3\plugins\com.adobe.cocomo
  • Macintosh: /Applications/Adobe Flex Builder 3/plugins/com.adobe.cocomo
• Redémarrez Flex Builder

Il faut créer un nouveau dossier "com.adobe.cocomo" dans le dossier plugins de votre Flex Builder à la main et copiez les fichiers directement dedans, ne faîtes pas de sous-dossiers

Lier le library path de votre projet au SWC

Cette manipulation est à faire pour tous les projets pour lesquels vous voudrez utilisez le framework Cocomo. Pour chaque projet, faîtes la manipulation suivante:

1. Clic droit sur le projet, puis Propriétés
2. Choisissez Flex Build Path
3. Choisissez à droite l'onglet Library Path
4. Cliquez sur "Add SWC"
5. Naviguez sur votre disque jusqu'à l'endroit où vous avez copié le framework puis choisissez le fichier SWC correspondant à la version de Flash (Flash Player 9 ou Flash Player 10) que vous voulez cibler. Ces SWC se trouvent dans le répertoire "lib" du framework.
6. Ajoutez cocomo.swc à votre library path puis OK

A des fins de debug, vous aurez peut-être besoin d'accéder au code source de Cocomo. Pour cela, allez cette fois dans l'onglet Source Path, puis Add Folder et ajoutez le répertoire "src" du framework Cocomo. Validez avec OK.

Votre environnement de travail est maintenant prêt à développer des applications Flex avec Adobe Cocomo!