Einrichten des Visual Studio-Projekts und Erstellen des Windows-Programms set-up-the-visual-studio-project-and-build-the-windows-app
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:
-
Öffnen Sie Software Distribution. Zum Anmelden bei Software Distribution benötigen Sie eine Adobe ID.
-
Tippen Sie im Kopfzeilenmenü auf Adobe Experience Manager.
-
Im Filter Abschnitt:
- Auswählen Forms von Lösung Dropdown-Liste.
- 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.
-
Tippen Sie auf den für Ihr Betriebssystem zutreffenden Paketnamen, wählen Sie EULA-Bedingungen akzeptieren und tippen Sie auf Herunterladen.
-
Öffnen Sie Package Manager und klicken Sie auf Paket hochladen, um das Paket hochzuladen.
-
Wählen Sie das Paket aus und klicken Sie auf Installieren.
-
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
.
Die folgende Abbildung zeigt die Verzeichnisstruktur des Ordners windows
im Ordner src
an.
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.
- 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. - Entpacken Sie das Archiv in das Verzeichnis
%HOMEPATH%\Projects\MobileWorkspace
. - Wechseln Sie in das Verzeichnis
%HOMEPATH%\Projects\MobileWorkspace\adobe-lc-mobileworkspace-src-[versionsrc]\windows
. - Ö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.
-
Wählen Sie in der Visual Studio-Standardsymbolleiste in der Dropdown-Liste für den Build-Modus die Option Release aus.
-
Wählen Sie je nach Plattform Windows-AnyCPU, Windows-x64 oder Windows-x86 aus. Windows-AnyCPU wird empfohlen.
-
Klicken Sie im Visual Studio Solution Explorer mit der rechten Maustaste auf das Projekt CordovaApp.Windows und wählen Sie Store > Create AppPackages.
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. -
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.
-
Nehmen Sie Änderungen an den Parameter wie der Version und dem Ausgabespeicherort des Programm-Builds vor wie benötigt.
-
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:- WinJS-Bibliothek
- Stellen Sie sicher, dass das Paket mit einem selbstsignierten Zertifikat oder einem von einer vertrauenswürdigen Stelle signierten öffentlichen Zertifikat wie VeriSign geliefert wird.
- Entwicklerlizenz
Der Ordner „Platforms\windows\AppPackages\CordovaApp.Windows_3.0.2.0_anycpu_Test“ enthält vier Hauptkomponenten:
- Datei
.appx
- Zertifikat (derzeit ein selbstsigniertes Zertifikat von Apache Cordova)
- Abhängigkeitsordner
- 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
-
Klicken Sie mit der rechten Maustaste auf die PowerShell-Datei (
Add-AppDevPackage.ps1)
, und wählen Sie Ausführen mit PowerShell. -
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.
-
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:
-
Führen Sie auf Ihrem Gerät
gpedit.msc
aus. -
Navigieren Sie zu Computerkonfiguration > Administrative Vorlagen > Windows-Komponente > Bereitstellung von App-Paketen.
-
Rechtsklick auf Installation aller vertrauenswürdigen Apps zulassen.
-
Klicken Bearbeiten und wählen Sie Aktiviert.
-
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:
-
Verbinden Sie das Gerät mithilfe des Remote-Debuggers.
Weitere Informationen finden Sie unter Ausführen von Windows Store-Apps auf einem Remote-Computer.
-
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.
-
Ihre App wird auf dem Remotecomputer bereitgestellt.