DokumentationAEM 6.5Benutzerhandbuch

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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Benutzende
  • Entwickler

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. Wählen Sie im Kopfzeilenmenü Adobe Experience Manager aus.

  3. Im Abschnitt Filter:

    1. Wählen Sie Formulare aus der Dropdown-Liste Lösung aus.
    2. Wählen Sie die Version aus und geben Sie sie für das Paket ein. Sie können auch die Option Downloads durchsuchen verwenden, um die Ergebnisse zu filtern.

  4. Wählen Sie den für Ihr Betriebssystem zutreffenden Paketnamen, dann EULA-Bedingungen akzeptieren und dann Herunterladen aus.

  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-1

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 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 setting-up-visual-studio-project-for-aem-forms-app

Führen Sie folgende 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.

Erstellen der AEM Forms-App 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 Ihrer Plattform „Windows-AnyCPU“, „Windows-x64“ oder „Windows-x86“ aus. 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.

    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. Nach Erstellung des Projekts können Sie die App mit folgenden Programmen 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 etwa 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 zum Installieren der Anwendung auf einem Windows-Gerät.

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

Verwenden von unternehmenseigenen Geräten 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 Edition von Windows.

Microsoft empfiehlt das Installieren eines von einer vertrauenswürdigen Stelle ausgestellten öffentlichen Zertifikats, wie etwa 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. 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 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. Diesen können Sie von einem Windows-Fachhä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 Unternehmens-Domain 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 deploying-an-app-using-visual-studio

Installieren der 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. 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 anschließend Remotecomputer aus.

  3. Ihre App wird auf dem Remote-Computer bereitgestellt.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2