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>.zip is a part of the adobe-aemfd-forms-app-src-pkg-<version>.zip package on package share.
To get the AEM Forms app source, perform the following steps:
- Navigate to package share
- Download the source package. When you download the package, it is added in your AEM Forms package manager.
- After it is downloaded, navigate to: http://<server>:<port>/crx/packmgr/index.jsp, and install adobe-aemfd-forms-app-src-pkg-<version>.zip.
- 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.
For Windows devices, you need:
- Microsoft Windows 8.1 or Windows 10
- Microsoft Visual Studio 2015
- Microsoft Visual Studio Tools for Apache Cordova
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 Solution Explorer, right-click the project CordovaApp.Windows and select Store > Create AppPackages.
The Create App Packages wizard appears.
The CordovaApp.Windows_220.127.116.11_anycpu.appx installer file is created in the platforms\windows\AppPackages\CordovaApp.Windows_18.104.22.168_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.
The .appx package requires the following items to install successfully:
- WinJS library
- Ensure that the package comes with a self-signed certificate, or a trusted authority signed public certificate such as VeriSign.
- Developer license
The directory Platforms\windows\AppPackages\CordovaApp.Windows_22.214.171.124_anycpu_Test contains the four main components in it:
- .appx file
- Certificate (Currently it is a self-signed certificate by Apache Cordova)
- Dependency folder
- PowerShell file (.ps1 extension)
- 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:
- Ensure that the device is joined to the domain of the enterprise.
- Enable group policy setting.
To enable group policy setting:
- In your device, run gpedit.msc.
- 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.
- Click OK.
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.