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, die für eine benutzerdefinierte AEM Forms-App erforderlich sind. Das Quellcode-Archiv adobe-lc-mobileworkspace-src-<version>.zip ist Teil des adobe-aemfd-forms-app-src-pkg-<version>.zip-Pakets zur Softwareverteilung.

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. Tippen Sie im Kopfzeilenmenü auf Adobe Experience Manager.

3. Im Abschnitt Filter:

   1. Wählen Sie Formulare aus der Dropdown-Liste Lösung.
   2. Wählen Sie die Version und den Typ für das Paket aus. Sie können die Ergebnisse auch mit der Option Downloads suchen filtern.

4. Tippen Sie auf den Paketnamen, der auf Ihr Betriebssystem zutrifft, wählen Sie EULA-Begriffe akzeptieren und tippen Sie auf 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. Um das Quellcode-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 enthält Details zum Inhalt des Ordners adobe-lc-mobileworkspace-src-[version]/ios.

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 Download-Ordner nach [User_Home]/Projects/.

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

4. Navigieren Sie zum Ordner [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​AEM Forms. Wählen Sie die Registerkarte Build Settings, suchen Sie den Abschnitt Code Signing Entitlement und führen Sie in den Feldern Debug und Release einen der folgenden Schritte aus:

   • Um eine Standard-Mobile Workspace-App zu erstellen, machen Sie keine Angaben in den Feldern
   • Geben Sie die Felder wie unter Erstellen einer sicheren AEM Forms-App für iOS beschrieben ein, um eine sichere AEM Forms-App zu erstellen.

7. Klicken Sie auf der Registerkarte Build Settings auf All und anschließend auf Combined.

8. Erweitern Sie in der Liste Settings das Element Code Signing.

9. Wählen Sie für Code Signing Identity die entsprechende Signatur. Detaillierte Informationen zum Erstellen neuer Signaturen finden Sie unter Erstellen und Herunterladen von Development Provisioning-Profilen.

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 die AEM Forms-App eine Verbindung zu einem Server herstellen muss, der nicht den App Transport Security-Anforderungen entspricht.

12. Wählen Sie unter PROJECT AEM Forms und stellen Sie sicher, dass die entsprechende Signatur für Code Signing Identity, Debug, Release und Any iOS SDK ausgewählt ist.

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

14. Wählen Sie das bereitgestellte Gerät für das Projekt AEM Forms aus.

    

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

15. Wählen Sie Product > Clean.

16. Wählen Sie Product > Build.

Installationsprogramm für die AEM Forms-App erstellen

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, z. B. den Namen und den Hostingort der App. Weitere Informationen zur Eigenschaftslistendatei finden Sie unter About Information Property List Files.

1. Verbinden Sie ein provisioniertes iPad mit einem Mac-Computer. Ausführliche Informationen zur Bereitstellung eines iPads finden Sie unter Erstellen und Herunterladen von Development Provisioning-Profilen

2. Wählen Sie das bereitgestellte Gerät für das Projekt AEM Forms aus.

   

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

3. Wählen Sie Product > Clean.

4. Wählen Sie Product > Build.

5. Wählen Sie Product > Archive.

6. Wählen Sie in Organizer unter „Archives“ das neueste Archiv Ihres Projekts aus und klicken Sie auf Distribute.

7. Wählen Sie die Verteilungsmethode Save for Enterprise or Ad-Hoc Deployment und klicken Sie auf Next.

8. Wählen Sie die entsprechende Option unter Code Signing Identity und klicken Sie auf Next. Klicken Sie auf Allow, um die Signatur anzuwenden.

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

10. Geben Sie im Feld Application URL die URL für die App an. Um die App beispielsweise auf einem CRX-Server zu hosten, geben Sie die URL https://[LC_host]:'port'/lc/content/distribution/mobileworkspace/APP_NAME.ipa ein.

11. Geben Sie im Feld Titel AEM Forms an.

12. Klicken Sie auf Save 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.