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 zum Erstellen einer benutzerdefinierten AEM Forms-App. 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.
-
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 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.
-
Im Build-Einstellungen Registerkarte, klicken Sie auf Alle und klicken Sie anschließend auf Kombiniert.
-
Aus dem Einstellungen Liste, erweitern 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-java <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-java <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.
-
Auswählen Produkt > Clean.
-
Auswählen Produkt > Build.
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 Eigenschaftenlistendatei (eine .plist-Datei) zu erstellen. Die Eigenschaftenlistendatei enthält Konfigurationsinformationen der gehosteten internen App, z. B. den Namen und den Hosting-Speicherort der App. Weitere Informationen zur Eigenschaftslistendatei finden Sie unter Informationen zu Listen-Dateien für Eigenschaften.
-
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.
-
Auswählen Produkt > Clean.
-
Auswählen Produkt > Build.
-
Auswählen Produkt > Archivieren.
-
Wählen Sie in Organizer - Archives das neueste Archiv Ihres Projekts aus und klicken Sie auf Verteilen.
-
Auswählen Für Enterprise- oder Ad-hoc-Bereitstellung speichern als Verteilungsmethode und klicken Sie auf Nächste.
-
Wählen Sie die entsprechende Code Signing Identity und klicken Sie auf Nächste. Klicken Zulassen , um die Signatur anzuwenden.
-
Geben Sie den Namen der App an und wählen Sie Save for Enterprise Distribution.
-
Stellen Sie die Anwendungs-URL für die App. 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. -
Im Titel -Feld AEM Forms angeben.
-
Klicken 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
.