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:

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

  2. Wählen Sie im Kopfzeilenmenü Adobe Experience Manager aus.

  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, dann EULA-Bedingungen akzeptieren und dann Herunterladen aus.

  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.

mws-content

Die folgende Tabelle zeigt Details zum Inhalt des Ordners „adobe-lc-mobileworkspace-src-[version]/ios“ an.

Verzeichnis
Inhalt
CordovaLib
PhoneGap SDK 6.4.0
AEM Forms
Ressourcen, PhoneGap-Plug-Ins und das Hauptmodul der Anwendung
AEM Forms.xcodeproj
Xcode-Projekt für AEM Forms-App
www
HTML, CSS, Bilder und JavaScript-Dateien für das AEM Forms-App-Projekt

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

  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:

  7. Klicken Sie auf der Registerkarte Build-Einstellungen auf Alle und anschließend auf Kombiniert.

  8. Erweitern Sie auf der Liste Einstellungen die Option 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:

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

    iPad

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

  15. Wählen Sie Produkt > Bereinigen aus.

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

  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.

    iPad-1

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

  3. Wählen Sie Produkt > Bereinigen aus.

  4. Wählen Sie  Produkt  > Aufbauen aus.

  5. Wählen Sie  Produkt > Archivieren aus.

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

  7. Wählen Sie die Verteilungsmethode  Für Unternehmens- oder Ad-hoc-Bereitstellung speichern aus und klicken Sie auf Weiter.

  8. Wählen Sie die entsprechende Option unter Code-Signaturidentität aus und klicken Sie auf Weiter.  Klicken Sie auf Zulassen, um die Signatur anzuwenden.

  9. Geben Sie den Namen der App an und wählen Sie Für Unternehmensverteilung speichern aus.

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

  11. Geben Sie im Feld Titel  „AEM Forms“ an.

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2