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 auf 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 auch die Option Downloads suchen verwenden, um die Ergebnisse zu filtern.

4. Tippen Sie auf den Paketnamen für Ihr Betriebssystem, wählen Sie Endbenutzer-Lizenzbedingungen akzeptieren und tippen Sie auf Download.

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

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

4. Navigieren Sie zum Verzeichnis [User_Home]/Projects/[your-project]/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 Debuggen und Freigeben einen der folgenden Schritte aus:

   • Um eine Standard-Mobile Workspace-App zu erstellen, machen Sie keine Angaben in den Feldern
   • Geben Sie die Felder an, wie unter Erstellen einer sicheren AEM Forms-App für iOS beschrieben, 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 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 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 Entwicklungsbereitstellungsprofilen

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 beispielsweise die App auf einem CRX-Server zu hosten, geben Sie die URL https://[LC_host]:'port'/lc/content/distribution/mobileworkspace/APP_NAME.ipa an.

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.