Commencez par BlackBerry Workspaces SDK

Les clients qui ont acheté Workspaces sont autorisés à déployer des serveurs de développement et de test conformément à leur contrat de licence. Les clients infonuagiques peuvent effectuer des tests sur leur instance de production. Contactez votre administrateur Workspaces pour accéder à l'API Workspaces.

Si vous n'avez pas déjà accès à BlackBerry Workspaces Vous avez deux options pour continuer :

1. Achetez-en un BlackBerry Workspaces compte cloud.

   Il s'agit de la solution recommandée pour bénéficier d'un accès complet aux espaces de travail et au soutien primé de BlackBerry. Moyennant un abonnement annuel modique, vous pouvez disposer d'un environnement de développement et de test dédié, déployé localement ou hébergé dans le nuage BlackBerry.  

   En plus de l'assistance téléphonique, les clients BlackBerry ont accès à un système de demandes de service en ligne ainsi qu'à toutes les ressources nécessaires pour déployer, gérer, soutenir et favoriser l'adoption de Workspaces par le portail des administrateurs BlackBerry.

2. Lancez un essai gratuit d'un environnement de développement et de test à court terme pour Workspaces.

Utilisation de l'API REST

• Guide du développeur -- Consultez le guide du développeur de l'API REST pour obtenir une vue d'ensemble, des informations sur l'authentification des requêtes et des exemples d'utilisation des différentes fonctionnalités du serveur Workspaces. 

• Référence de l'API -- La référence de l'API décrit les interfaces, les classes, les méthodes et les types de données de l'API. BlackBerry Workspaces API REST. 

• Exemples -- Consultez des exemples de code utilisant des espaces de travail, des utilisateurs et des fichiers.  

Utilisation du SDK Java

• Bibliothèque Java — Téléchargez et installez les bibliothèques de code du kit de développement logiciel (SDK) Java Workspaces. Deux fichiers JAR sont disponibles : un fichier JAR compact contenant uniquement les classes du SDK et un fichier JAR complet incluant les classes du SDK et toutes leurs dépendances.
  

• Guide du développeur -- Consultez le guide du développeur Java pour obtenir une vue d'ensemble du SDK, des informations sur l'authentification des requêtes auprès des API et des exemples d'utilisation des différentes fonctionnalités du serveur Workspaces. 

• Référence API -- La documentation de l'API décrit les interfaces, les classes, les méthodes et les énumérations de BlackBerry Workspaces Trousse de développement logiciel (SDK) Java. 

• Exemples -- Consultez des exemples de code utilisant des espaces de travail, des utilisateurs et des fichiers.  

Utilisation du SDK .NET

• Bibliothèque SDK
  

• Guide du développeur -- Consultez le guide du développeur .NET pour obtenir une vue d'ensemble du SDK, des informations sur l'authentification des requêtes auprès des API et des exemples d'utilisation des différentes fonctionnalités du serveur Workspaces. 

• Référence API -- La documentation de l'API décrit les interfaces, les classes, les méthodes et les énumérations de BlackBerry Workspaces Trousse de développement logiciel .NET. 

• Exemples -- Consultez des exemples de code utilisant des espaces de travail, des utilisateurs et des fichiers.  

Utilisation du SDK Android

• Bibliothèque SDK

• Guide du développeur — Consultez le guide du développeur Android pour obtenir une présentation du SDK, des renseignements sur l’authentification des requêtes auprès des API et des exemples d’utilisation des différentes fonctionnalités du serveur Workspaces. 

• Référence API -- La documentation de l'API décrit les interfaces, les classes, les méthodes et les énumérations de BlackBerry Workspaces Kit de développement logiciel (SDK) Android.

• Exemples -- Consultez des exemples de code utilisant des espaces de travail, des utilisateurs et des fichiers. 

Mode de simulation d'entreprise

Pour exécuter et tester une application BlackBerry Dynamics, un serveur BlackBerry UEM est nécessaire. Cependant, malgré des limitations importantes, le mode de simulation d'entreprise permet de tester une application sans connexion à un serveur BlackBerry UEM

En mode de simulation d'entreprise, aucune authentification utilisateur n'est requise au niveau de l'entreprise ; par conséquent, aucune communication ne transite par le pare-feu de l'entreprise. Si l'application nécessite une connexion derrière le pare-feu, un BlackBerry sera alors utilisé. UEM Un serveur est nécessaire.

Important : le mode de simulation d'entreprise n'est pas destiné à un environnement de production et son exécution est limitée au simulateur iOS.

 Bien que le mode de simulation d'entreprise ne soit pas adapté au déploiement en production d'une application, il est utile pendant le développement et pour vérifier le bon fonctionnement et le comportement lors de la migration d'applications existantes vers BlackBerry Dynamics.

En mode simulation, aucune clé d'activation valide n'est requise pour ouvrir l'application, car aucune communication directe n'est établie avec les serveurs de BlackBerry Dynamics. La communication avec le centre d'opérations réseau (NOC) de BlackBerry Dynamics demeure toutefois active.

 Pour activer le mode de simulation d'entreprise pour une application BlackBerry Dynamics, ajoutez les éléments suivants au fichier config.xml racine et reconstruisez le projet :
 

<preference name=“GDEnterpriseSimulationMode” value=“true” />

Pour la désactiver, changez la valeur à faux ou supprimez complètement la préférence.

Lors du premier lancement d'une application BlackBerry Dynamics sur un système cible, celle-ci doit être activée sur le serveur BlackBerry Dynamics. En mode de simulation d'entreprise , toute adresse courriel et toute clé d'accès de 15 caractères sont acceptées pour l'activation. Une fois l'application activée, elle invite l'utilisateur à créer un mot de passe.

Le lien « Exigences relatives aux mots de passe » au bas de l’écran fournit des indications sur la complexité requise pour les mots de passe. Hors du mode de simulation d'entreprise, la complexité des mots de passe est contrôlée par des stratégies gérées par votre administrateur informatique. UEM console de gestion.

Le mode de simulation d'entreprise présente les différences suivantes par rapport à l'exécution standard en entreprise :

• [Simulé] apparaîtra dans l'interface utilisateur de BlackBerry Dynamics Runtime.

• Toute adresse courriel et clé d'activation seront acceptées pour l'activation en entreprise.

• Aucune information n'est réellement envoyée aux serveurs de l'entreprise, y compris l'adresse courriel et la clé d'activation.

• Le flux de configuration de l'approvisionnement et des politiques est simulé dans l'interface utilisateur.

• Un ensemble de politiques de sécurité et de conformité prédéfinies est en vigueur ; l'authentification n'est pas déléguée.

• Lorsqu'elle est exécutée sur un appareil physique et non sur un émulateur, l'application sera effacée.

• Toute tentative de modification du mode de GDEnterprise à GDEnterpriseSimulation pour une application déjà installée sur un appareil entraînera la suppression de l'application.

• Aucune récupération de mot de passe perdu n'est disponible.

• La communication interconteneurs (ICC) ne peut pas être utilisée, ce qui signifie que l'API BlackBerry Dynamics Services ne peut pas être utilisée.

Sinon, les API de stockage sécurisé, de communication sécurisée et de canal push sont toutes disponibles en mode de simulation d'entreprise .

Les API de communication ne pourront pas se connecter aux serveurs d'applications d'entreprise via le UEM serveur, bien que des connexions directes aux serveurs d'applications d'entreprise restent possibles, par exemple si le simulateur iOS est exécuté sur une machine qui se trouve sur le réseau d'entreprise ou le VPN.

Utilisation de BlackBerry UEM serveur

Un BlackBerry UEM ou BlackBerry UEM Une instance infonuagique est nécessaire pour effectuer les tests sur un téléphone intelligent ou une tablette réelle.

Suivez les étapes requises pour configurer une application BlackBerry Secured en vue de tests. UEM Si vous n'en avez pas encore un UEM Une fois votre instance en place, vous pouvez en configurer une avec une licence d'essai gratuite pour développeur. Cliquez ici pour générer une licence d'essai et commencer la configuration de votre serveur.

Une fois les serveurs installés, poursuivez avec les étapes suivantes.

1) Configurez l'application sur BlackBerry UEM ou BlackBerry UEM Nuage

La première étape consiste à définir l'application dans le BlackBerry. UEM 

1. Connectez-vous à votre BlackBerry. UEM console de gestion.

2. Cliquez sur Applications > Nouvelle application > Droits d'accès aux applications internes BlackBerry Dynamics > Suivant.

3. Spécifiez l'ID et la version du droit d'accès BlackBerry Dynamics définis dans le fichier Info.plist. Par exemple : com.mycompany.testApp et 1.0.0.0.

4. Cliquez sur Ajouter.

Votre application figurera dans la liste des applications disponibles. Si vous devez fournir des paramètres de configuration supplémentaires, comme l'autorisation de serveurs ou la configuration d'une politique d'application, sélectionnez votre application dans la liste et configurez-la en conséquence.

Recommandation : Ajoutez l’identifiant du bundle à la configuration de l’application. Cela permet l’ activation simplifiée , évitant ainsi la saisie d’une clé d’accès au premier lancement. Cette étape est également nécessaire si votre application utilise les services BlackBerry AppKinetics.

Pour ajouter ces valeurs :

1. Cliquez sur l'application.

2. Dans l'onglet iOS, entrez la valeur appropriée

3. Cliquez sur Enregistrer.

2) Désactiver la détection antidébogage

Mûre UEM Cette fonctionnalité empêche l'exécution des versions de débogage des applications BlackBerry Dynamics. Pour permettre le développement d'applications, cette option doit être désactivée dans le profil de conformité attribué à l'utilisateur effectuant les tests.

Pour désactiver cette stratégie, suivez les étapes ci-dessous :

1. Connectez-vous à UEM console de gestion.

2. Dans le menu de gauche, cliquez sur Politiques et profils > Conformité.

3. Ouvrez le profil de conformité attribué à l'utilisateur de test.

4. Dans l'onglet iOS, si l'option « Système d'exploitation jailbreaké » est cochée, assurez-vous que l'option « Activer l'antidébogage pour les applications BlackBerry Dynamics » n'est pas sélectionnée.

3) Permettre aux utilisateurs de l'application

Une fois l'application enregistrée sur un BlackBerry UEM Pour installer et utiliser l'application sur le serveur, les utilisateurs doivent être autorisés. Ces permissions peuvent être accordées à des utilisateurs individuels ou à des groupes d'utilisateurs. En production, il est recommandé d'utiliser des groupes d'utilisateurs. Lors du développement ou des tests, l'utilisation d'utilisateurs individuels est suffisante.

Pour assigner une application à un utilisateur individuel, suivez les étapes suivantes :

1. Connectez-vous à UEM console de gestion.

2. Trouvez et sélectionnez un compte utilisateur.

3. Dans la section Applications de votre profil utilisateur, cliquez sur +.

4. Trouvez et sélectionnez votre application.

5. Cliquez sur Suivant.

6. Laissez le champ Disposition sur facultatif (l'installation ne sera pas forcée) et cliquez sur Attribuer.

7. Selon la configuration de votre délégué d'authentification, vous devrez peut-être générer un mot de passe d'activation qui sera utilisé lors du premier lancement de l'application après son installation.

Pour générer un nouveau mot de passe d'activation :

1. Dans le profil de l'utilisateur, sous l'onglet Résumé, cliquez sur Définir le mot de passe d'activation .

2. Dans la liste déroulante des options d'activation, cliquez sur Activation par défaut de l'appareil .

3. Dans la liste déroulante Mot de passe d'activation, cliquez sur Définir le mot de passe d'activation de l'appareil .

4. Dans le champ « Mot de passe d'activation de l'appareil », entrez le mot de passe à utiliser lors du premier lancement de l'application après son installation.

5. À des fins de développement, il peut être utile de prolonger la période d'activation jusqu'à la durée maximale permise (30 jours).

6. Cliquez sur Soumettre.

7. L'utilisateur reçoit un courriel contenant les identifiants et un code QR qui peut être utilisé pour activer l'application lors de son premier lancement après l'installation.
   Le courriel envoyé à l'utilisateur est également visible depuis le UEM console en cliquant sur le lien « Afficher le courriel d’activation »

8. Installez l'application sur la cible prévue en utilisant la méthode de déploiement préférée (y compris via Xcode).

9. Lorsque vous y êtes invité, sélectionnez un type d'activation parmi ceux disponibles. 

   • Utilisez « saisir les identifiants » pour utiliser directement votre adresse courriel et votre mot de passe d'activation.

   • Utilisez l'option « Scanner le code QR » si l'application est exécutée sur un appareil doté d'un appareil photo et si le code QR figurant dans le courriel d'activation peut être scanné même à partir d'un écran.