Build the AEM Forms Android app

Search
Experience Manager 6.4 Forms User Guide

On this page

Applies to: Experience Manager 6.4 Forms

在中国购买的 Creative Cloud 产品不含 CC 桌面应用程序中的 Creative Cloud 移动应用程序和在线服务及相关功能。

You're viewing help content for version:

Perform the following steps in the recommended sequence to build the Android app for AEM Forms.

  1. Download the AEM Forms App Source Code Package
  2. Set the environment variables
  3. Build standard AEM Forms app

Download the AEM Forms App Source Code Package

AEM Forms App Source Code Package refers to the adobe-lc-mobileworkspace-src-<version>.zip archive. This archive includes the source code required to build a custom AEM Forms app. The archive is included in the adobe-aemfd-forms-app-src-pkg-<version>.zip package available on the package share.

Perform the following steps to download the adobe-aemfd-forms-app-src-pkg-<version>.zip file:

  1. Log in to the author instance of the AEM server as an administrator and open package share. You require an Adobe ID to log in to the package share.

  2. In AEM package share, search adobe-aemfd-forms-app-src-pkg-<version>.zip, click the package applicable to your operating system, and click Download. Read and accept the license agreement and click OK. The download starts. Once downloaded, the word Downloaded appears next to the package.

  3. After the download completes, click Downloaded. You are redirected to package manager.  In the package manager, search the downloaded package, and click Install.

  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 Android app .zip file is downloaded on your device.

  5. Extract the contents of the .zip file to a folder on your local file system. For example, C:\<Folder Structure>\adobe-lc-mobileworkspace-src-2.4.20

The following image displays the structure of the adobe-lc-mobileworkspace-src-<version>.zip\android folder.

zip_android_folder_structure

Set the environment variables

Set the following environment variables before starting the build process for the AEM Forms app:

  • Set the JAVA_HOME environment variable to the location of JDK software on the local file system. For example, C:\Program Files\Java\jdk1.8.0_181
  • Set the ANDROID_SDK_ROOT system environment variable to the SDK location for Android. For example, C:\Users\<username>\AppData\Local\Android\Sdk
  • Set the Path system environment variable to include the platform-tools and tools folder locations for Android. For example, C:\Users\<username>\AppData\Local\Android\Sdk\platform-tools and C:\Users\<username>\AppData\Local\Android\Sdk\tools.

Build standard AEM Forms app

Once you have saved the adobe-lc-mobileworkspace-src-<version>.zip file on the local file system and set the environment variables, build standard AEM Forms Android app using any of the following options:

Build AEM Forms app using Android Studio

Perform the following steps to build AEM Forms app using Android Studio:

  1. Launch the Android Studio application on your machine.

  2. Click Open an existing Android Studio project. If the dialog box to open an existing project does not appear automatically, select File > Open.

  3. Navigate to adobe-lc-mobileworkspace-src-<version>.zip/android on the local file system and click OK.
    The android option is displayed in the left pane.

     

    android_folder_studio

  4. Select android from the left pane and click Run > Run 'android'.

  5. Select the Android device from the Connected Devices section on the Select Deployment Target dialog box and click OK.
    Once you have built the development environment successfully, you can now apply customizations on the app. Use the following articles to customize the app:

    After applying appropriate customizations to your app, you can generate the .apk file for distribution.

Generate .apk file using Android Studio

Execute the following steps to generate the .apk file using Android Studio:

  1. Launch the Android Studio application on your machine.

  2. Select Open an existing Android Studio project. If the dialog box to open an existing project does not appear automatically, select File > Open.

  3. Navigate to adobe-lc-mobileworkspace-src-<version>.zip/android on the local file system and click OK.
    The android option is displayed in the left pane.

  4. Select Build > Build APK to generate the .apk file.

    Optionally, Select Build > Generate Signed APK to generate a signed version of the .apk file.

Use Android Debug Bridge

Once the .apk file has been generated, execute the following command to install the application on an Android device using the Android Debug Bridge.

Windows users: adb install %HOMEPATH%\Projects\[your-project]\adobe-lc-mobileworkspace-src-[version]\android\build\outputs\apk\android-debug.apk

MAC users: adb install [User_Home]/Projects/[your-project]/adobe-lc-mobileworkspace-src-[version]/android/build/outputs/apk/android-debug.apk

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy