AEM Forms provides the complete source code of the AEM Forms app. The source contains all components to build a custom workspace application. The source code archive,
adobe-lc-mobileworkspace-src-<version>.zipis a part of the
adobe-aemfd-forms-app-src-pkg-<version>.zip package on Software Distribution.
To get the AEM Forms app source, perform the following steps:
Open Software Distribution. You require an Adobe ID to log in to the Software Distribution.
Tap Adobe Experience Manager available in the header menu.
In the Filters section:
Tap the package name applicable to your operating system, select Accept EULA Terms, and tap Download.
Open Package Manager and click Upload Package to upload the package.
Select the package and click Install.
To download the source code archive, open
https://<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
The following image displays the directory structure of the
windows folder in the
For Windows devices, you need:
Perform the following steps to set up the AEM Forms app project in Visual Studio.
%HOMEPATH%\Projectsfolder in the Windows 8.1 or Windows 10 device with Visual Studio 2015 installed and configured.
CordovaApp.slnfile using Visual Studio 2015 and proceed to building the AEM Forms app.
Perform the following steps to build and deploy AEM Forms app.
Data stored on Windows file system for AEM Forms app is not encrypted. It is recommended that you use a third-party tool like Windows BitLocker Drive Encryption to encrypt disk data.
In the Visual Studio Standard Toolbar, select Release from the drop-down for build mode.
Select Windows-AnyCPU, Windows-x64, or Windows-x86 based on your platform. Windows-AnyCPU is recommended.
In the Visual Studio Solution Explorer, right-click the project CordovaApp.Windows and select Store > Create AppPackages.
The Create App Packages wizard appears.
The CordovaApp.Windows_126.96.36.199_anycpu.appx installer file is created in the platforms\windows\AppPackages\CordovaApp.Windows_188.8.131.52_anycpu_Test directory.
If you encounter the error
Retarget to windows 8.1 required, right-click the error and in the pop-up menu, select Retarget To Windows 8.1.
In the Create App Packages wizard, select weather or not you want to upload your app to the windows store and then click Next.
Make the changes in the parameters, such as the version and output location of the app build, as required.
After the project is built, you can install the app using:
.appx package requires the following items to install successfully:
The directory Platforms\windows\AppPackages\CordovaApp.Windows_184.108.40.206_anycpu_Test contains the four main components in it:
There are two ways to install the application on a Windows device.
Right-click on the PowerShell file (
Add-AppDevPackage.ps1), and choose Run with PowerShell.
The setup prompts you to get a developer license. Use Microsoft account credentials to acquire developer license.
This license is valid for 30 days, and you can renew it for free.
When you acquire the developer license, the setup installs the self-signed certificate on the system and application installs successfully.
For enterprise owned devices that are joined to the domain of the enterprise, acquiring a developer license is not required.
Enterprise owned devices use Professional and Enterprise editions of Windows.
Microsoft recommends that you install a trusted authority issued public certificate such as VeriSign.
To deploy the app:
To enable group policy setting:
In your device, run
Navigate to Computer Configuration > Administrative Templates > Windows Component > App Package Deployment.
Right-click on Allow all trusted apps to install.
Click Edit and select Enabled.
Edit the Visual Studio generated PowerShell script to stop it from acquiring developer license.
In the PowerShell script, set the variable:
$NeedDeveloperLicense = $false.
For devices that are not domain-joined, side-loading product activation key is required. You can purchase it from a Windows reseller.
For Windows 8.1 Home edition, there is no group policy, the enterprise side-loading is not allowed, and you cannot join it with the enterprise domain. Deploy the app on a Windows 8.1 Home Edition device using developer license.
For more information, click here.
To install the app on Windows using Visual Studio:
Connect the device using remote debugger.
For more information, see Run Windows Store apps on a remote machine.
With your app open in Visual Studio, choose Windows-x64, Windows-x86, or Windows-AnyCPU from the Solution Platforms list, and select Remote Machine.
Your app is deployed on the remote machine.