29.7.2. Installing developer tools

29.7.2.1. General information

Depending on the configuration being developed, the developer may need different developer tools:

To develop a mobile application, the developer mobile platform is required.
To develop a mobile application, the developer mobile client is required.
To develop a mobile application with standalone mode, the developer mobile client with standalone mode is required.

The generation algorithms of developer tools are the same for both the mobile platform and the mobile client. Differences are present only in the file names used in different situations. To prepare the mobile platform for iOS developers, get the prjios.zip file from the distribution package of the mobile 1C:Enterprise version (the mobile.zip file). For the mobile client, use the prjios_client.zip file. For the mobile client with standalone mode, use the prjios_standalone.zip file.

The table shows respective file names for various client applications of the mobile 1C:Enterprise version:

Mobile operating system Client application kind	File name
Android
Mobile platform	1cem-arm.apk 1cem-arm64.apk 1cem-x86.apk 1cem-x86_64.apk
Mobile client	1cem-client-arm.apk 1cem-client-arm64.apk 1cem-client-x86.apk 1cem-client-x86_64.apk
Mobile client with standalone mode	1cem-standalone-arm.apk 1cem-standalone-arm64.apk 1cem-standalone-x86.apk 1cem-standalone-x86_64.apk
iOS
Mobile platform	prjios.zip prjios_sim.zip
Mobile client	prjios_client.zip prjios_client_sim.zip
Mobile client with standalone mode	prjios_standalone.zip prjios_standalone_sim.zip
Windows
Mobile platform	1cem-arm.appx 1cem-x64.appx 1cem-x86.appx
Mobile client	1cem-client-arm.appx 1cem-client-x64.appx 1cem-client-x86.appx
Mobile client with standalone mode	1cem-standalone-arm.appx 1cem-standalone-x64.appx 1cem-standalone-x86.appx

In this table:

‑arm, ‑arm64, ‑x86, ‑x64, and ‑x86_64 denote the architecture of the processor in use.
‑sim denotes a version to be used in the device emulator (applicable to iOS development only).

29.7.2.2. On Android

To develop a mobile application on Android, fulfill the following requirements:

Install Android Studio on your computer (http://developer.android.com/studio/index.html). For the developer platform to work, Android SDK Platform-tools version 26 or later must be installed on the computer.
Use Android Studio to check whether all the required components are installed. To do this, in the start window, select Configure ‑ SDK Manager. For convenience, you can select the Show Package Details check box in the opened window.
On the Platforms SDK tab, you can check the availability of required Android SDK versions.

Fig. 511. Selecting Android SDK versions

On the SDK Tools tab, specify Android SDK Build-Tools and Android SDK Platform-Tools. We recommend that you install all the Tools and SDK consistently. In this case, all versions will be compatible with each other. We do not recommend that you install incomplete versions such as rc, beta, and so on. The builder will not accept these versions as suitable for use. For example, fig. 512 shows that Android SDK Build-Tools can be updated to version 31.0.0 rc5. Do not install this update!

Fig. 512. Selecting tool versions

After the settings have been configured, click OK or Apply to start the installation process of the required components. Before starting the installation process, Android Studio will ask to confirm the installation of the selected components (indicating the entire list).
The computer must have one free USB port used to communicate with the mobile device.
You also need a mobile device on Android that meets the system requirements.

To install the mobile 1C:Enterprise version for developers on a mobile device on Android, do the following:

In the settings of the mobile device, select the following check boxes:
- Unknown sources
- USB debugging
Download the USB driver for mobile devices from the manufacturer’s website and install it on your computer.
Attach the mobile device to the computer.
Using the Windows command line interpreter, execute the command:

Example for ARM platform:

%ANDROID_SDK%\platform tools\adb.exe install ‑r "<Platform directory>\1cem arm.apk"

Example for x86 platform:

%ANDROID_SDK%\platform tools\adb.exe install ‑r "<Platform directory>\1cem x86.apk"

Where Platform directory is the directory in which the corresponding file with the mobile 1C:Enterprise version is located. If the mobile 1C:Enterprise version is already installed on the mobile device, this command will reinstall it.

The mobile 1C:Enterprise version will be passed to the mobile device, and its icon will appear in the list of installed applications.
The mobile device can be disconnected from the computer. After that, the system can be started by tapping the 1C:Enterprise icon in the list of mobile device applications.

To install the mobile 1C:Enterprise version for developers, you can use the following Designer command:

For the mobile platform: Main menu ‑ Configuration ‑ Mobile application ‑ Use Android Debug Bridge ‑ Install mobile platform.
For the mobile client: Main Menu ‑ Configuration ‑ Mobile client ‑ Use Android debug bridge ‑ Install mobile client.

In this case, you will need to perform additional setup of Designer. The mobile platform can be installed either on a physical mobile device attached to a computer or on a device emulator created in Android Virtual Device Manager. Android Virtual Device Manager can be started from Android Studio: Main menu ‑ Tools ‑ Android ‑ AVD Manager.

29.7.2.3. On iOS

To develop a mobile application for iOS, fulfill the following requirements:

You can use a mobile device only from an Apple computer (hereinafter referred to as Mac) with OS X 11 or later.
A Mac computer must have one free USB port for connection with the mobile device.
On this computer, install the Xcode development tool version 12.5 or later (https://developer.apple.com/xcode/).
Register in iOS Developer Program (https://developer.apple.com/programs/ios/).
You also need a mobile device on iOS that meets the system requirements.

To install the mobile 1C:Enterprise version for developers on a mobile device on iOS, do the following:

Install an Xcode package on a Mac computer.
Start Xcode.
Add a developer account to Xcode:
- On the Accounts tab, open Xcode settings (Xcode ‑ Preferences).
- In the lower left corner of the form, click +. In the list of account types, select Apple ID and click Continue. In the opened dialog box, enter a username and Apple ID password for the developer account.
- After the account is added, development teams linked to the added account become available in Xcode.
Attach the mobile device to the Mac computer.
Unpack the file with the required project of the mobile 1C:Enterprise version on the Mac computer.
Open the mobile 1C:Enterprise version for developers in the Xcode system. To do it, double click the 1cem.xcodeproj file or select the 1cem.xcodeproj file by clicking File ‑ Open.
In the project settings, click the Signing & Capabilities tab. In the Team field, select one of the development teams that became available after adding the developer account to Xcode.
In the Bundle Identifier field, enter the application ID.
Open the Organizer tool by clicking Window ‑ Organizer.
In the left panel of the opened window, select the attached phone (highlighted in green).
In the bottom panel, select Add to Portal.
The Organizer tool will request required phone certificates and the provisioning profile from the Apple website and automatically install them on the phone. You will need to enter the developer password received during registration in the iOS Developer Program.
Click Product ‑ Edit Scheme… to open a dialog box where you can set up the current startup scheme. In the opened dialog box:
- In the Scheme property, select 1cem.
- In the Destination property, select the attached phone.
- In the Build configuration property, select Release.
- Click OK.
Start the project by clicking Product ‑ Run.
The mobile 1C:Enterprise version will be transferred to the mobile device, started, and its icon will appear in the list of installed applications of the mobile device.
The mobile device can be disconnected from the Mac computer. After that, start the mobile 1C:Enterprise version by clicking the 1C:Enterprise icon in the list of mobile device applications. If the mobile 1C:Enterprise version for developers is running on Xcode at the moment of disconnection, it is closed.

29.7.2.4. On Windows

To develop a mobile application for Windows, fulfill the following requirements:

Operation with mobile devices is supported only on computers running Windows 8.1 or later.
You need to have a Microsoft account (https://login.live.com/).
For operation, you need a device on Windows (tablet or computer with a touch screen) that meets the system requirements.

To install the mobile 1C:Enterprise version for developers on a device running Windows, do the following:

Copy the distribution file of the mobile 1C:Enterprise version to the device (mobile.zip).
Extract the 1cem.cer certificate file from it.
Install the certificate in the Trusted people store on the local computer.
Extract a file with the required distribution package of desired architecture from the distribution file of the mobile 1C:Enterprise version.
Start PowerShell as the administrator (system administrator rights are insufficient).
Execute the following command:

Show WindowsDeveloperLicenseRegistration

In the opened window, specify the Microsoft account information.

Execute the following command:

Add AppxPackage <Directory>\<file name>.appx

Where:

<Directory> is the directory where the mobile 1C:Enterprise version for developers is placed.
<file name> is the name of the platform version to be installed.
- After that, you can start the system by tapping the 1C:Enterprise icon in the list of applications.

<< Prev Next >>