Einrichten des Xcode-Projekts und Erstellen der iOS-App set-up-the-xcode-project-and-build-the-ios-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 AEM Forms-App 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 AEM Forms App-Quelle zu erhalten, führen Sie die folgenden Schritte aus:
-
Öffnen Sie Software Distribution. Zum Anmelden bei Software Distribution benötigen Sie eine Adobe ID.
-
Wählen Sie im Kopfzeilenmenü Adobe Experience Manager aus.
-
Im Abschnitt Filter:
- Wählen Sie Formulare aus der Dropdown-Liste Lösung aus.
- 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.
-
Wählen Sie den für Ihr Betriebssystem zutreffenden Paketnamen, dann EULA-Bedingungen akzeptieren und dann Herunterladen aus.
-
Ö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.
-
Öffnen Sie
https://<server>:<port>/crx/de/content/forms/mobileapps/src/adobe-lc-mobileworkspace-src-<version>.zip
in Ihrem Browser, um das Quell-Code-Archiv herunterzuladen.
Das Quellpaket wird auf Ihr Gerät heruntergeladen.
Die folgende Abbildung zeigt den extrahierten Inhalt von adobe-lc-mobileworkspace-src-<version>.zip
.
Die folgende Tabelle zeigt Details zum Inhalt des Ordners „adobe-lc-mobileworkspace-src-[version]/ios
“ an.
Weitere Informationen zu Codesignaturen und zum Hinzufügen von Geräten im iOS Provisioning Portal finden Sie unter iOS Code Signing Setup, Process, and Troubleshooting.
Standardmäßige AEM Forms-App erstellen set-up-the-xcode-project
-
Führen Sie die folgenden Schritte aus, um ein Projekt in Xcode einzurichten und eine signierende Identität anzugeben:
Melden Sie sich bei Ihrem Mac-Computer an, auf dem Xcode und iOS SDK installiert und konfiguriert sind.
-
Kopieren Sie das Archiv
adobe-lc-mobileworkspace-src-<version>.zip
aus dem Downloads-Ordner nach[User_Home]/Projects/
. -
Extrahieren Sie das Archiv im Verzeichnis
[User_Home]/Projects/[your-project]
. -
Navigieren Sie zum Verzeichnis
[User_Home]/Projects/
[Ihr Projekt]/adobe-lc-mobileworkspace-src-[version]/ios
. -
Öffnen Sie das Projekt
AEM Forms.xcodeproj
in Xcode. -
Klicken Sie auf AEM Forms und wählen Sie unter TARGETS die Option AEM Forms. Wählen Sie die Registerkarte Build-Einstellungen, suchen Sie den Abschnitt Code Signing-Berechtigung und führen Sie in den Feldern „Debugging“ und „Freigeben“ einen der folgenden Schritte aus:
- Um eine Standard-Mobile Workspace-App zu erstellen, machen Sie keine Angaben in den Feldern
- Um ein sicheres AEM Forms-Programm zu erstellen, füllen Sie die Felder aus wie unter Erstellen eines sicheren AEM Forms-Programms für iOS beschrieben.
-
Klicken Sie auf der Registerkarte Build-Einstellungen auf Alle und anschließend auf Kombiniert.
-
Erweitern Sie auf der Liste Einstellungen die Option Code-Signierung.
-
Wählen Sie für Code Signing Identity die entsprechende Signatur. Weitere Informationen zum Erstellen neuer Signaturen erhalten Sie unter Erstellen und Herunterladen von Entwicklungsbereitstellungsprofilen.
-
Achten Sie darauf, dass dieselbe Signatur für die Optionen Debug, Release und Any iOS SDK ausgewählt wird.
-
Ersetzen Sie den folgenden Code in der Datei
AEM Forms-info.plist
:code language-xml <key>NSAppTransportSecurity</key> <dict> <key>NSAllowsArbitraryLoads</key> <true/> </dict>
durch den folgenden, wenn Sie
yourserver.com
durch den entsprechenden Hostnamen für Ihren Server ersetzen.code language-xml <key>NSAppTransportSecurity</key> <dict> <key>NSExceptionDomains</key> <dict> <key>yourserver.com</key> <dict> <!-Include to allow subdomains-> <key>NSIncludesSubdomains</key> <true/> <!-Include to allow HTTP requests-> <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key> <true/> <!-Include to support forward secrecy-> <key>NSExceptionRequiresForwardSecrecy</key> <false/> <!-Include to specify minimum TLS version-> <key>NSTemporaryExceptionMinimumTLSVersion</key> <string>TLSv1.1</string> </dict> </dict> </dict>
note note NOTE Dieser Schritt ist nur erforderlich, wenn das AEM Forms-Programm eine Verbindung zu einem Server herstellen muss, der nicht den App Transport Security-Anforderungen entspricht. -
Wählen Sie unter PROJEKT die Option AEM Forms aus und vergewissern Sie sich, dass die entsprechende Signatur für Code Signing Identity, Debugging, Freigabe und Alle iOS-SDKs ausgewählt ist.
-
Verbinden Sie ein provisioniertes iPad mit einem Mac-Computer.
-
Wählen Sie das provisionierte Gerät für das AEM Forms-Projekt.
Ein provisioniertes Gerät (iPad Air 2) ist ausgewählt.
-
Wählen Sie Produkt > Bereinigen aus.
-
Wählen Sie Produkt > Build aus.
Installationsprogramm für die AEM Forms-App erstellen build-the-installer-for-the-mobile-workspace-app
Sie müssen das Xcode-Projekt archivieren, um das Installationsprogramm (eine .ipa-Datei) und eine Eigenschaftslistendatei (eine .plist-Datei) zu erstellen. Die Eigenschaftslistendatei enthält Konfigurationsinformationen der gehosteten internen App, wie den Namen und den Hosting-Speicherort der App. Weitere Informationen zur Eigenschaftslistendatei finden Sie unter Informationen zu Informationseigenschaftslistendateien.
-
Verbinden Sie ein provisioniertes iPad mit einem Mac-Computer. Ausführliche Informationen für die Bereitstellung eines iPads finden Sie unter Erstellen und Herunterladen von Entwicklungsbereitstellungsprofilen.
-
Wählen Sie das provisionierte Gerät für das AEM Forms-Projekt.
Ein provisioniertes Gerät (iPad Air 2) ist ausgewählt.
-
Wählen Sie Produkt > Bereinigen aus.
-
Wählen Sie Produkt > Aufbauen aus.
-
Wählen Sie Produkt > Archivieren aus.
-
Wählen Sie in Organizer unter „Archive“ das neueste Archiv Ihres Projekts aus und klicken Sie auf Verteilen.
-
Wählen Sie die Verteilungsmethode Für Unternehmens- oder Ad-hoc-Bereitstellung speichern aus und klicken Sie auf Weiter.
-
Wählen Sie die entsprechende Option unter Code-Signaturidentität aus und klicken Sie auf Weiter. Klicken Sie auf Zulassen, um die Signatur anzuwenden.
-
Geben Sie den Namen der App an und wählen Sie Für Unternehmensverteilung speichern aus.
-
Geben Sie die Anwendungs-URL für die App an. Um beispielsweise das Programm auf einem CRX-Server zu hosten, geben Sie die URL
https://[LC_host]:'port'/lc/content/distribution/mobileworkspace/APP_NAME.ipa
an. -
Geben Sie im Feld Titel „AEM Forms“ an.
-
Klicken Sie auf Speichern und schließen Sie Xcode.
Die Installationsprogrammdatei
AEM Forms.ipa
und die EigenschaftslistendateiAEM Forms-info.plist
werden am angegebenen Speicherort erstellt. -
Öffnen Sie die Datei
AEM Forms-info.plist
in einem Editor. -
Ersetzen Sie alle Leerzeichen in der URL der .ipa-Datei durch %20.
-
Speichern und schließen Sie die Datei
AEM Forms-info.plist
.