Set up the Visual Studio project and build the Windows app

Cerca
Experience Manager 6.2 Forms Guida utente

Su questa pagina

Prodotti interessati: Experience Manager 6.2 Forms

某些 Creative Cloud 应用程序、服务和功能在中国不可用。

Visualizzazione del contenuto dell'aiuto per la versione :

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.

Nota:

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 Setting up the environment.

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.

MWS-Content

The following image displays the directory structure of the windows folder in the src folder.

win-dir

Setting up the environment

For Windows devices, you need:

  • Microsoft Windows 8.1 or Windows 10
  • Microsoft Visual Studio 2015
  • Microsoft Visual Studio Tools for Apache Cordova

Setting up Visual Studio Project for AEM Forms app

Perform the following steps to set up the AEM Forms app project in Visual Studio.

  1. Copy the adobe-lc-mobileworkspace-src-<version>.zip archive to %HOMEPATH%\Projects folder in the Windows 8.1 or Windows 10 device with Visual Studio 2015 installed and configured.

  2. Extract the archive in the %HOMEPATH%\Projects\MobileWorkspace directory.

  3. Navigate to the %HOMEPATH%\Projects\MobileWorkspace\src\windows directory.

  4. Open the MWSWindows.sln file using Visual Studio 2015.

  5. Open config.xml.

  6. Navigate to the Plugins tab.

  7. In the Plugins Window, navigate to the Custom tab. In this window, select Local method to retrieve the plug-in.

  8. Click Browse and select %HOMEPATH%\Projects\MobileWorkspace\src\windows\MWSWindows\ADReachability.

  9. Click Add that appears on the right tab to add the plug-in.

  10. Repeat steps 8 and 9 for the following plug-ins:

    • %HOMEPATH%\Projects\MobileWorkspace\src\windows\
      MWSWindows\ChildBrowser
    • %HOMEPATH%\Projects\MobileWorkspace\src\windows\
      MWSWindows\FormUtility
    • %HOMEPATH%\Projects\MobileWorkspace\src\windows\
      MWSWindows\NativeUtils
    • %HOMEPATH%\Projects\MobileWorkspace\src\windows\
      MWSWindows\WindowsAccountManager
    • %HOMEPATH%\Projects\MobileWorkspace\src\windows\
      MWSWindows\TaskPinPlugin
    • %HOMEPATH%\Projects\MobileWorkspace\src\windows\
      MWSWindows\CordovaPlugins\cordova-plugin-camera
    • %HOMEPATH%\Projects\MobileWorkspace\src\windows\
      MWSWindows\CordovaPlugins\cordova-plugin-file
    • %HOMEPATH%\Projects\MobileWorkspace\src\windows\
      MWSWindows\CordovaPlugins\cordova-plugin-file-transfer
    • %HOMEPATH%\Projects\MobileWorkspace\src\windows\
      MWSWindows\CordovaPlugins\cordova-plugin-websql
    • %HOMEPATH%\Projects\MobileWorkspace\src\windows\
      MWSWindows\CordovaPlugins\cordova-plugin-dialogs
    • %HOMEPATH%\Projects\MobileWorkspace\src\windows\
      MWSWindows\CordovaPlugins\cordova-plugin-actionsheet

    Nota:

    Do not insert a space in the complete path mentioned, as it stops you from adding a plug-in. 

  11. In the Visual Studio Solution Explorer, navigate to the MWSWindows\plugins folder and verify that folders are created for the plug-ins added above.

Build AEM Forms app

Perform the following steps to build and deploy AEM Forms app.

Nota:

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.

  1. In the Visual Studio Standard Toolbar, select Release from the drop-down for build mode.

  2. Select Windows-AnyCPU, Windows-x64, or Windows-x86 based on your platform. Windows-AnyCPU is recommended.

  3. In the Visual Studio Solution Explorer, select the project MWSWindows, right-click on the project, and select build option.

    The CordovaApp.Windows_3.0.2.0_anycpu.appx installer file is created in the platforms\windows\AppPackages\CordovaApp.Windows_3.0.2.0_anycpu_Test directory.

  4. After the project is built, you can install the app using:

    • Windows PowerShell
    • Visual Studio

    The .appx package requires the following items to install successfully:

    1. WinJS library
    2. Ensure that the package comes with a self-signed certificate, or a trusted authority signed public certificate such as VeriSign.
    3. Developer license

    The directory Platforms\windows\AppPackages\CordovaApp.Windows_3.0.2.0_anycpu_Test contains the four main components in it:

    1. .appx file 
    2. Certificate (Currently it is a self-signed certificate by Apache Cordova)  
    3. Dependency folder
    4. PowerShell file (.ps1 extension)

Deploying an app using Windows PowerShell

There are two ways to install the application on a Windows device. 

By acquiring the developer license

  1. Right-click on the PowerShell file (Add-AppDevPackage.ps1), and choose Run with PowerShell.
  2. 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.
  3. When you acquire the developer license, the setup installs the self-signed certificate on the system and application installs successfully.

By using enterprise owned devices

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:

  1. In your device, run gpedit.msc.
  2. Navigate to Computer Configuration > Administrative Templates > Windows Component > App Package Deployment.
  3. Right-click on Allow all trusted apps to install.
  4. Click Edit and select Enabled.
  5. 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.

Deploying an app using Visual Studio

To install the app on Windows using Visual Studio:

  1. Connect the device using remote debugger.
    For more information, see Run Windows Store apps on a remote machine.
  2. With your app open in Visual Studio, choose Windows-x64, Windows-x86, or Windows-AnyCPU from the Solution Platforms list, and select Remote Machine.
  3. Your app is deployed on the remote machine.