You're viewing help content for version:

AEM Forms provides the complete source code of the AEM Forms app. The source contains all components to build custom AEM Forms app. The source code archive, adobe-lc-mobileworkspace-src-<version>.zip is a part of the adobe-aemfd-forms-app-src-pkg-<version>.zip package on package share. 


If you already have the source code archive, adobe-lc-mobileworkspace-src-<version>.zip, you can ignore the steps listed below and directly go to Build standard AEM Forms app.

To get the AEM Forms app source, perform the following steps:

  1. Navigate to package share
    URL: http://<server>:<port>/crx/packageshare.
  2. Download the source package. When you download the package, it is added in your AEM Forms package manager.
  3. After it is downloaded, navigate to: http://<server>:<port>/crx/packmgr/index.jsp, and install adobe-aemfd-forms-app-src-pkg-<version>.zip.
  4. To download the source code archive, open http://<server>:<port>/crx/de/content/forms/mobileapps/src/adobe-lc-mobileworkspace-src-<version>.zip in your browser. 
    The source package is downloaded on your device. 

The following image displays the extracted contents of the adobe-lc-mobileworkspace-src-<version>.zip.


The following table details contents of the src/ios folder.




PhoneGap SDK 5.0


Resources, PhoneGap plug-ins, and application's main module


Xcode project for AEM Forms app


HTML, CSS, images, and JavaScript files for the AEM Forms app project

For detailed information about Code Signing and adding devices to the iOS Provisioning Portal, see iOS Code Signing Setup, Process, and Troubleshooting.

Build standard AEM Forms app

  1. Perform the following steps to set up a project in Xcode and provide a signing identity:

    Log in to your Mac machine that has Xcode , and iOS SDK installed and configured.

  2. Copy the adobe-lc-mobileworkspace-src-<version>.zip archive from the downloads folder to [User_Home]/Projects/.

  3. Extract the archive in the[User_Home]/Projects/[your-project] directory.

  4. Navigate to the [User_Home]/Projects/[your-project]/src/ios directory.

  5. Open the Capture.xcodeproj project in Xcode.

  6. Click Capture, under TARGETS, select Capture. Select the Summary tab, locate the Entitlement section, and uncheck Use Entitlements File checkbox.

    The Xcode builds a standard Mobile Worspace app if the Use Entitlements File option is unchecked. To build a Secure AEM Forms app, see Building a Secure AEM Forms app for iOS.

  7. In the Build Settings tab, click All and then click Combined.

  8. From the Settings list, expand Code Signing.

  9. For Code Signing Identity, select the appropriate signature. For detailed information about, creating new signatures, see Creating and Downloading Development Provisioning Profiles.

  10. Ensure that the same signature is selected for Debug, Release, and Any iOS SDK.

  11. Replace the following code in the Capture-info.plist file: 


    with the following while replacing with an appropriate host name for your server.

    <!-Include to allow subdomains->
    <!-Include to allow HTTP requests->
    <!-Include to support forward secrecy->
    <!-Include to specify minimum TLS version->


    This step is required only if AEM Forms app needs to connect to a server that does not follow App Transport Security requirements.

  12. Under PROJECT, select Capture and ensure that the appropriate signature is selected for Code Signing Identity, Debug, Release and Any iOS SDK.

  13. Connect a provisioned iPad to a Mac machine.

  14. Select the provisioned device for the Capture project.

    A provisioned device, Mobdec Ipad3-1, is selected.

  15. Select Product > Clean.

  16. Select Product > Build.

Build the installer for the AEM Forms app

You need to archive the Xcode project to build the installer (an .ipa file) and a property list (a .plist file) file. The property list file contains configuration information of the hosted in-house app, such as the name and the hosting location of the app. For more information about property list file, see About Information Property List Files.

  1. Connect a provisioned iPad to a Mac machine. For detailed information about provisioning an iPad, see Creating and Downloading Development Provisioning Profiles

  2. Select the provisioned device for the Capture project.

    A provisioned device, Mobdec Ipad3-1, is selected.

  3. Select Product > Clean.

  4. Select Product > Build.

  5. Select Product > Archive.

  6. In Organizer - Archives, select the latest archive of your project and click Distribute.

  7. Select Save for Enterprise or Ad-Hoc Deployment as the method of distribution and click Next.

  8. Select the appropriate Code Signing Identity and click Next. Click Allow to apply the signature.

  9. Provide name of the app and select Save for Enterprise Distribution.

  10. Provide the Application URL for the app. For example, to host the app on a CRX server, provide URL http://[LC_host]:[port]/lc/content/distribution/mobileworkspace/APP_NAME.ipa.

  11. In the Title field, specify Capture.

  12. Click Save and close Xcode.

    An installer file, Capture.ipa, and property list file, Capture.plist, are created at the specified location.

  13. Open the Capture.plist file in an editor.

  14. Replace all the spaces in the URL of your .ipa file with %20.

  15. Save and close the Capture.plist file.