Configuration du projet Visual Studio et création d’une application Windows

AEM Forms fournit le code source complet de l’application AEM Forms. La source contient tous les composants nécessaires pour générer une application d’espace de travail personnalisée. L'archive de code source adobe-lc-mobileworkspace-src-<version>.zipfait partie du package adobe-aemfd-forms-app-src-pkg-<version>.zip sur la distribution de logiciels.

Pour obtenir le code source de l’application AEM Forms, procédez comme suit :

1. Ouvrez Distribution de logiciels. Vous avez besoin d’un Adobe ID pour vous connecter à la Distribution de logiciels.

2. Appuyez sur Adobe Experience Manager dans le menu d’en-tête.

3. Dans la section Filtres :

   1. Sélectionnez Formulaires dans la liste déroulante Solution.
   2. Sélectionnez la version et le type du package. Vous pouvez également utiliser l'option Rechercher les téléchargements pour filtrer les résultats.

4. Appuyez sur le nom du package correspondant à votre système d’exploitation, sélectionnez Accepter les termes du contrat de licence de l’utilisateur final, puis appuyez sur Télécharger.

5. Ouvrez Package Manager et cliquez sur Télécharger le package pour télécharger le package.

6. Sélectionnez le package et cliquez sur Installer.

7. Pour télécharger l'archive du code source, ouvrez https://<server>:<port>/crx/de/content/forms/mobileapps/src/adobe-lc-mobileworkspace-src-<version>.zip dans votre navigateur.

   Le package source est téléchargé sur votre périphérique.

L'image suivante affiche le contenu extrait du fichieradobe-lc-mobileworkspace-src-<version>.zip.

L'image suivante affiche la structure de répertoires du dossier windows dans le dossier src.

Configuration de l’environnement

Pour les périphériques Windows, vous devez disposer des éléments suivants :

• Microsoft Windows 8.1 ou Windows 10
• Microsoft Visual Studio 2015
• Outils Microsoft Visual Studio pour Apache Cordova

Installation du projet Visual Studio pour l’application AEM Forms

Exécutez les étapes suivantes pour configurer le projet de l’application AEM Forms dans Visual Studio.

1. Copiez l'archive adobe-lc-mobileworkspace-src-<version>.zip dans le dossier %HOMEPATH%\Projects du périphérique Windows 8.1 ou Windows 10 avec Visual Studio 2015 installé et configuré.
2. Extrayez l'archive dans le répertoire %HOMEPATH%\Projects\MobileWorkspace.
3. Accédez au répertoire %HOMEPATH%\Projects\MobileWorkspace\adobe-lc-mobileworkspace-src-[versionsrc]\windows.
4. Ouvrez le fichier CordovaApp.sln à l’aide de Visual Studio 2015 et continuez à créer l’application AEM Forms.

Génération de l'application AEM Forms

Suivez les étapes ci-après pour générer et déployer l’application AEM Forms.

1. Dans la barre d'outils Visual Studio Standard, sélectionnez Release dans la liste déroulante pour le mode de création.

2. Sélectionnez Windows-AnyCPU, Windows-x64 ou Windows-x86 en fonction de votre plateforme. Windows-AnyCPU est recommandé.

3. Dans l'Explorateur de solutions Visual Studio, cliquez avec le bouton droit sur le projet CordovaApp.Windows et sélectionnez Magasin > Créer des paquets d'applications.

   

   L’assistant de création de packs d’applications s’affiche.

   Le fichier d’installation CordovaApp.Windows_3.0.2.0_anycpu.appx est créé dans le répertoire platforms\windows\AppPackages\CordovaApp.Windows_3.0.2.0_anycpu_Test.

   Si vous rencontrez l'erreur Retarget to windows 8.1 required, cliquez avec le bouton droit de la souris sur l'erreur et dans le menu contextuel, sélectionnez Recibler sur Windows 8.1.

   

4. Dans l’assistant Créer des packages d’application, indiquez si vous souhaitez charger votre application dans Windows Store, puis cliquez sur Suivant.

   

5. Effectuez les modifications dans les paramètres, tels que la version et l’emplacement de sortie de la build de l’application, selon les besoins.

   

6. Une fois que le projet est créé, vous pouvez installer l’application à l’aide des éléments suivants :

   • Windows PowerShell
   • Visual Studio

   Le package .appx nécessite l'installation des éléments suivants :

   1. Bibliothèque WinJS
   2. Assurez-vous que le package s’accompagne d’un certificat auto-signé ou qu’une autorité approuvée, telle que VeriSign, a signé le certificat public.
   3. Licence de développeur

   Le répertoire Platforms\windows\AppPackages\CordovaApp.Windows_3.0.2.0_anycpu_Test contient les quatre composants principaux suivants :

   1. .appx approuvé
   2. Certificat (il s’agit actuellement d’un certificat signé Apache Cordova)
   3. Dossier de dépendance
   4. Fichier PowerShell (.ps1 extension)

Déploiement d’une application à l’aide de Windows PowerShell

Il existe deux manières d’installer l’application sur un périphérique Windows.

Via l’acquisition d’une licence développeur

1. Cliquez avec le bouton droit sur le fichier PowerShell ( Add-AppDevPackage.ps1), puis choisissez Exécuter avec PowerShell.

2. La configuration vous invite à obtenir une licence développeur. Utilisez les informations de connexion de votre compte Microsoft pour l’acquérir.

   Cette licence est valable pendant 30 jours et peut être renouvelée gratuitement.

3. Lors de l’acquisition de la licence développeur, la configuration entraîne l’installation d’un certificat auto-signé sur le système et l’application s’installe correctement.

Via des périphériques d’entreprise

Pour les périphériques d’entreprise connectés au domaine de l’entreprise, la licence développeur n’est pas obligatoire.

Les périphériques d’entreprise utilisent Windows Professionnel et Windows Entreprise.

Microsoft recommande d’installer un certificat public émis par une autorité de confiance, telle que VeriSign.

Pour déployer l’application :

• Assurez-vous que le périphérique est joint au domaine de l’entreprise.
• Activez le paramètre de stratégie de groupe.

Pour activer le paramètre de stratégies de groupe :

1. Sur votre périphérique, exécutez gpedit.msc.

2. Accédez à Configuration de l’ordinateur > Modèles d’administration > Composant Windows > Déploiement du package de l’application.

3. Cliquez avec le bouton droit de la souris sur Autoriser toutes les applications de confiance pour l’installation.

4. Cliquez sur Modifier puis sélectionnez Activé.

5. Cliquez sur OK.

Modifiez le script PowerShell généré par Visual Studio pour l’empêcher d’acquérir la licence de développeur.

Dans le script PowerShell, définissez la variable : $NeedDeveloperLicense = $false.

Pour les périphériques non connectés à un domaine, la clé de sideloading d’activation du produit est requise. Vous pouvez l’acheter auprès d’un revendeur Windows.

Pour Windows 8.1 Famille, il n’y a aucune stratégie de groupe. Le sideloading d’entreprise n’est pas activé et vous ne pouvez pas effectuer de connexion avec le domaine d’entreprise. Déployez l’application sur un périphérique exécutant Windows 8.1 Famille lors de l’utilisation de la licence de développeur.

Pour plus d’informations, cliquez ici.

Déploiement d’une application à l’aide de Visual Studio

Pour installer l’application sous Windows à l’aide de Visual Studio :

1. Connectez le périphérique à l’aide du débogueur à distance.

   Pour plus d’informations, voir Exécution d’applications Windows Store sur un ordinateur distant.

2. Avec l’application ouverte dans Visual Studio, sélectionnez Windows x64, Windows-x86 ou Windows-AnyCPU à partir de la liste des plateformes de solution, puis sélectionnez Ordinateur distant.

3. Votre application est déployée sur un ordinateur distant.