Einrichten des Visual Studio-Projekts und Erstellen der Windows-App

In AEM Forms wird der vollständige Quellcode der AEM Forms-App bereitgestellt. Die Quelle enthält alle Komponenten, die für eine benutzerdefinierte Workspace-Anwendung erforderlich sind. Das Quellcode-Archiv adobe-lc-mobileworkspace-src-<version>.zipist Teil des adobe-aemfd-forms-app-src-pkg-<version>.zip-Pakets zur Softwareverteilung.

Um die AEM Forms App-Quelle zu erhalten, führen Sie die folgenden Schritte aus:

  1. Öffnen Sie Software-Distribution. Zum Anmelden bei Software Distribution benötigen Sie eine Adobe ID.

  2. Tippen Sie im Kopfzeilenmenü auf Adobe Experience Manager.

  3. Im Abschnitt Filter:

    1. Wählen Sie Formulare aus der Dropdown-Liste Lösung.
    2. Wählen Sie die Version und den Typ für das Paket aus. Sie können die Ergebnisse auch mit der Option Downloads suchen filtern.

  4. Tippen Sie auf den Paketnamen, der auf Ihr Betriebssystem zutrifft, wählen Sie EULA-Begriffe akzeptieren und tippen Sie auf Herunterladen.

  5. Öffnen Sie Package Manager und klicken Sie auf Paket hochladen, um das Paket hochzuladen.

  6. Wählen Sie das Paket aus und klicken Sie auf Installieren.

  7. Um das Quellcode-Archiv herunterzuladen, öffnen Sie https://<server>:<port>/crx/de/content/forms/mobileapps/src/adobe-lc-mobileworkspace-src-<version>.zip in Ihrem Browser.
    Das Quellpaket wird auf Ihr Gerät heruntergeladen.

Die folgende Abbildung zeigt den extrahierten Inhalt von adobe-lc-mobileworkspace-src-<version>.zip.

mws-content-1

Die folgende Abbildung zeigt die Ordnerstruktur des Ordners windows im Ordner src.

win-dir

Einrichten der Umgebung

Für Windows-Geräte benötigen Sie Folgendes:

  • Microsoft Windows 8.1 oder Windows 10
  • Microsoft Visual Studio 2015
  • Microsoft Visual Studio-Tools für Apache Cordova

Einrichten des Visual Studio-Projekts für die AEM Forms-App

Führen Sie folgende Schritte durch, um das AEM Forms-App-Projekt in Visual Studio einzurichten:

  1. Kopieren Sie das Archiv adobe-lc-mobileworkspace-src-<version>.zip in den Ordner %HOMEPATH%\Projects auf dem Windows 8.1- oder Windows 10-Gerät, auf dem Visual Studio 2015 installiert und konfiguriert ist.
  2. Extrahieren Sie das Archiv im Ordner %HOMEPATH%\Projects\MobileWorkspace.
  3. Navigieren Sie zum Ordner %HOMEPATH%\Projects\MobileWorkspace\adobe-lc-mobileworkspace-src-[versionsrc]\windows.
  4. Öffnen Sie die Datei CordovaApp.sln in Visual Studio 2015 und erstellen Sie die AEM Forms-App.

Erstellen der AEM Forms-App

Führen Sie die folgenden Schritte zum Erstellen und Bereitstellen der AEM Forms-App durch:

HINWEIS

Im Windows-Dateisystem für die AEM Forms-App gespeicherte Daten werden nicht verschlüsselt. Es wird empfohlen, zum Verschlüsseln von Festplattendaten ein Drittanbieter-Tool wie die Windows BitLocker Drive Encryption zu verwenden.

  1. Wählen Sie in der Visual Studio Standard-Symbolleiste Release aus der Dropdownliste für den Buildmodus.

  2. Wählen Sie je nach Ihrer Plattform Windows-AnyCPU, Windows-x64 oder Windows-x86. Empfohlen wird Windows-AnyCPU.

  3. Klicken Sie im Visual Studio Solution Explorer mit der rechten Maustaste auf das Projekt CordovaApp.Windows und wählen Sie Store > Create AppPackages.

    createapppackages

    Der Assistent zum Erstellen der App-Pakete wird angezeigt.

    Die Installationsprogrammdatei CordovaApp.Windows_3.0.2.0_anycpu.appx wird im Ordner platforms\windows\AppPackages\CordovaApp.Windows_3.0.2.0_anycpu_Test erstellt.

    Wenn der Fehler Retarget to windows 8.1 required auftritt, klicken Sie mit der rechten Maustaste auf den Fehler und wählen Sie im Popupmenü Retarget To Windows 8.1.

    retarget-solution

  4. Wählen Sie im Assistenten zum Erstellen von App-Paketen, ob Sie Ihre App in den Windows Store hochladen möchten, und klicken Sie dann auf Weiter.

    createapackageswizard1

  5. Nehmen Sie Änderungen an den Parameter wie der Version und dem Ausgabespeicherort des App-Builds vor wie benötigt.

    createapackageswizard2

  6. Nach Erstellung des Projekts können Sie die App mit folgenden Programmen installieren:

    • Windows PowerShell
    • Visual Studio

    Zum erfolgreichen Installieren des .appx-Pakets sind die folgenden Elemente erforderlich:

    1. WinJS-Bibliothek
    2. Stellen Sie sicher, dass das Paket mit einem selbstsignierten Zertifikat oder einem von einer vertrauenswürdigen Stelle signierten öffentlichen Zertifikat, wie etwa VeriSign, geliefert wird.
    3. Entwicklerlizenz

    Der Ordner Platforms\windows\AppPackages\CordovaApp.Windows_3.0.2.0_anycpu_Test enthält die vier Hauptkomponenten:

    1. .appx file
    2. Zertifikat (derzeit ein selbstsigniertes Zertifikat von Apache Cordova)
    3. Abhängigkeitsordner
    4. PowerShell-Datei (.ps1-Erweiterung)

Bereitstellen einer App mit Windows PowerShell

Es gibt zwei Möglichkeiten zum Installieren der Anwendung auf einem Windows-Gerät.

Erwerb der Entwicklerlizenz

  1. Klicken Sie mit der rechten Maustaste auf die PowerShell-Datei ( Add-AppDevPackage.ps1) und wählen Sie Mit PowerShell ausführen.

  2. Bei der Einrichtung werden Sie dazu aufgefordert, eine Entwicklerlizenz zu erwerben. Verwenden Sie die Microsoft-Kontoanmeldeinformationen zum Erwerben der Entwicklerlizenz.
    Diese Lizenz ist für 30 Tage gültig, und Sie können Sie kostenlos verlängern.

  3. Wenn Sie die Entwicklerlizenz erwerben, installiert das Setupprogramm das selbstsignierte Zertifikat auf dem System und die Anwendung wird erfolgreich installiert.

Verwenden von unternehmenseigenen Geräten

Für unternehmenseigene Geräte, die in die Unternehmensdomäne eingebunden sind, ist der Erwerb einer Entwicklerlizenz nicht erforderlich.

Unternehmenseigene Geräte verwenden die Professional und Enterprise Edition von Windows.

Microsoft empfiehlt das Installieren eines von einer vertrauenswürdigen Stelle ausgestellten öffentlichen Zertifikats, wie etwa VeriSign.

So stellen Sei die App bereit:

  • Stellen Sie sicher, dass das Gerät in die Unternehmensdomäne eingebunden ist.
  • Aktivieren Sie die Gruppenrichtlinien-Einstellung.

So aktivieren Sie die Gruppenrichtlinien-Einstellung:

  1. Führen Sie auf Ihrem Gerät gpedit.msc aus.

  2. Navigieren Sie zu Computerkonfiguration > Administrative Vorlagen > Windows-Komponente > Bereitstellung von App-Paketen.

  3. Klicken Sie mit der rechten Maustaste auf Installation aller vertrauenswürdigen Apps zulassen.

  4. Klicken Sie auf Bearbeiten und wählen Sie Aktiviert.

  5. Klicken Sie auf OK.

Bearbeiten Sie das von Visual Studio generierte PowerShell-Skript, um zu verhindern, dass eine Entwicklerlizenz erworben wird.

Legen Sie im PowerShell-Skript die Variable fest: $NeedDeveloperLicense = $false.

Für Geräte, die nicht in die Domäne eingebunden sind, ist ein Querladen des Produktaktivierungsschlüssels erforderlich. Diesen können Sie von einem Windows-Händler erwerben.

Für die Windows 8.1 Home Edition gibt es keine Gruppenrichtlinie, ein Querladen innerhalb des Unternehmens ist nicht zulässig und Sie können sie nicht in die Unternehmensdomäne einbinden. Stellen Sie die App mithilfe der Entwicklerlizenz auf einem Gerät mit Windows 8.1 Home Edition bereit.

Klicken Sie hier, um weitere Informationen zu erhalten.

Bereitstellen einer App mit Visual Studio

So installieren Sie die App mit Visual Studio unter Windows:

  1. Verbinden Sie das Gerät mithilfe von Remotedebugger.
    Weitere Informationen finden Sie unter Windows Store-Apps auf einem Remotecomputer ausführen.

  2. Wählen Sie, während Sie die App in Visual Studio geöffnet haben, in der Liste der Lösungsplattformen Windows-x64, Windows-x86 oder Windows-AnyCPU und wählen Sie anschließend Remotecomputer.

  3. Ihre App wird auf dem Remotecomputer bereitgestellt.

Auf dieser Seite