Einrichten des Visual Studio-Projekts und Erstellen des Windows-Programms set-up-the-visual-studio-project-and-build-the-windows-app

CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

In AEM Forms wird der vollständige Quell-Code des AEM Forms-Programms bereitgestellt. Die Quelle enthält alle Komponenten, die für ein benutzerdefiniertes Arbeitsbereich-Programm erforderlich sind. Das Quell-Code-Archiv adobe-lc-mobileworkspace-src-<version>.zip ist Bestandteil des adobe-aemfd-forms-app-src-pkg-<version>.zip-Pakets auf Software Distribution.

Um die Quelle des AEM Forms-Programms 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 Filter Abschnitt:

    1. Auswählen Forms von Lösung Dropdown-Liste.
    2. Wählen Sie die Version aus und geben Sie für das Paket ein. Sie können auch die Option Downloads durchsuchen verwenden, um die Ergebnisse zu filtern.
  4. Tippen Sie auf den für Ihr Betriebssystem zutreffenden Paketnamen, wählen Sie EULA-Bedingungen 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 Quell-Code-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-2

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

win-dir

Einrichten der Umgebung setting-up-the-environment

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

  • Microsoft Windows 8.1 oder Windows 10
  • Microsoft Visual Studio 2015
  • Microsoft Visual Studio Tools for Apache Cordova

Einrichten eines Visual Studio-Projekts für die AEM Forms-App setting-up-visual-studio-project-for-aem-forms-app

Führen Sie die folgenden Schritte aus, 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 mit installiertem und konfiguriertem Visual Studio 2015.
  2. Entpacken Sie das Archiv in das Verzeichnis %HOMEPATH%\Projects\MobileWorkspace.
  3. Wechseln Sie in das Verzeichnis %HOMEPATH%\Projects\MobileWorkspace\adobe-lc-mobileworkspace-src-[versionsrc]\windows.
  4. Öffnen Sie die Datei CordovaApp.sln in Visual Studio 2015 und erstellen Sie das AEM Forms-Programm.

AEM Forms-App erstellen build-aem-forms-app

Führen Sie die folgenden Schritte aus, um die AEM Forms-App zu erstellen und bereitzustellen.

NOTE
Im Windows-Dateisystem für die AEM Forms-App gespeicherte Daten werden nicht verschlüsselt. Es wird empfohlen, zum Verschlüsseln von Festplattendaten ein Tool eines Drittanbieters, wie etwa die BitLocker-Laufwerkverschlüsselung von Windows, zu verwenden.
  1. Wählen Sie in der Visual Studio-Standardsymbolleiste in der Dropdown-Liste für den Build-Modus die Option Release aus.

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

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

    createappackages

    Der Assistent zum Erstellen der Programmpakete 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 Popup-Menü Neu auf Windows 8.1 aus.

    retarget-solution

  4. Wählen Sie im Assistenten zum Erstellen von Programmpaketen, ob Sie Ihr Programm in den Windows Store hochladen möchten, und klicken Sie dann auf Weiter.

    createapppackageswizard1

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

    createapppackageswizard2

  6. Nachdem das Projekt erstellt wurde, können Sie die App wie folgt installieren:

    • Windows PowerShell
    • Visual Studio

    Das .appx-Paket erfordert für eine erfolgreiche Installation folgende Elemente:

    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 VeriSign geliefert wird.
    3. Entwicklerlizenz

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

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

Bereitstellen einer App mit Windows PowerShell deploying-an-app-using-windows-powershell

Es gibt zwei Möglichkeiten, die Anwendung auf einem Windows-Gerät zu installieren.

Erwerb der Entwicklerlizenz by-acquiring-the-developer-license

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

  2. Beim Setup werden Sie aufgefordert, eine Entwicklerlizenz zu erhalten. Verwenden Sie Microsoft-Kontoanmeldeinformationen, um eine Entwicklerlizenz zu erwerben.

    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 Setup das selbstsignierte Zertifikat auf dem System und die Anwendung wird erfolgreich installiert.

Verwendung unternehmenseigener Geräte by-using-enterprise-owned-devices

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

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

Microsoft empfiehlt die Installation eines von einer vertrauenswürdigen Stelle ausgestellten öffentlichen Zertifikats wie VeriSign.

So stellen Sie das Programm bereit:

  • Stellen Sie sicher, dass das Gerät in die Unternehmens-Domain 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. Rechtsklick auf Installation aller vertrauenswürdigen Apps zulassen.

  4. Klicken 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 die Variable im PowerShell-Skript wie folgt fest: $NeedDeveloperLicense = $false.

Für Geräte, die nicht in die Domain eingebunden sind, ist ein Querladen des Produktaktivierungsschlüssels erforderlich. Sie können es von einem Windows-Wiederverkäufer 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 Unternehmens-Domain einbinden. Stellen Sie die App mithilfe der Entwicklerlizenz auf einem Windows 8.1 Home Edition-Gerät bereit.

Klicken Sie für weitere Informationen auf here.

Bereitstellen einer App mit Visual Studio deploying-an-app-using-visual-studio

So installieren Sie die App mit Visual Studio unter Windows:

  1. Verbinden Sie das Gerät mithilfe des Remote-Debuggers.

    Weitere Informationen finden Sie unter Ausführen von Windows Store-Apps auf einem Remote-Computer.

  2. Wenn Ihre App in Visual Studio geöffnet ist, wählen Sie Windows-x64, Windows-x86 oder Windows-AnyCPU aus der Liste der Lösungsplattformen und wählen Sie Remote-Computer.

  3. Ihre App wird auf dem Remotecomputer bereitgestellt.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da