Einrichten des Xcode-Projekts und Erstellen der 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:

1. Öffnen Sie Software Distribution. Zum Anmelden bei Software Distribution benötigen Sie eine Adobe ID.

2. Auswählen Adobe Experience Manager im Kopfzeilenmenü verfügbar.

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 aus und wählen Sie EULA-Bedingungen akzeptieren und wählen Sie 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. Ö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

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

2. Kopieren Sie das Archiv adobe-lc-mobileworkspace-src-<version>.zip aus dem Downloads-Ordner nach [User_Home]/Projects/.

3. Extrahieren Sie das Archiv im Verzeichnis [User_Home]/Projects/[your-project].

4. Navigieren Sie zum Verzeichnis [User_Home]/Projects/[Ihr Projekt]/adobe-lc-mobileworkspace-src-[version]/ios.

5. Öffnen Sie das Projekt AEM Forms.xcodeproj in Xcode.

6. 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.

7. Im Build-Einstellungen Registerkarte, klicken Alle und klicken Sie anschließend auf Kombiniert.

8. Aus dem Einstellungen Liste, erweitern Code-Signierung.

9. 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.

10. Achten Sie darauf, dass dieselbe Signatur für die Optionen Debug, Release und Any iOS SDK ausgewählt wird.

11. Ersetzen Sie den folgenden Code in der Datei AEM Forms-info.plist:

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

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

    HINWEIS

    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.

12. 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.

13. Verbinden Sie ein provisioniertes iPad mit einem Mac-Computer.

14. Wählen Sie das provisionierte Gerät für das AEM Forms-Projekt.

    

    Ein provisioniertes Gerät, iPad Air 2, ist ausgewählt.

15. Auswählen Produkt > Clean.

16. Auswählen Produkt > Build.

Installationsprogramm für die AEM Forms-App erstellen

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.

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

2. Wählen Sie das provisionierte Gerät für das AEM Forms-Projekt.

   

   Ein provisioniertes Gerät, iPad Air 2, ist ausgewählt.

3. Auswählen Produkt > Clean.

4. Auswählen Produkt > Build.

5. Auswählen Produkt > Archivieren.

6. Wählen Sie in Organizer - Archives das neueste Archiv Ihres Projekts aus und klicken Sie auf Verteilen.

7. Auswählen Für Enterprise- oder Ad-hoc-Bereitstellung speichern als Verteilungsmethode und klicken Sie auf Nächste.

8. Wählen Sie die entsprechende Code Signing Identity und klicken Nächste. Klicks Zulassen , um die Signatur anzuwenden.

9. Geben Sie den Namen der App an und wählen Sie Save for Enterprise Distribution.

10. 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.

11. Im Titel -Feld, geben Sie AEM Forms an.

12. Klicks Speichern und schließen Sie Xcode.

    Die Installationsprogrammdatei AEM Forms.ipa und die Eigenschaftslistendatei AEM Forms-info.plist werden am angegebenen Speicherort erstellt.

13. Öffnen Sie die Datei AEM Forms-info.plist in einem Editor.

14. Ersetzen Sie alle Leerzeichen in der URL der .ipa-Datei durch %20.

15. Speichern und schließen Sie die Datei AEM Forms-info.plist.