Skip to main content
Samsung Developer Program

Binary File Registration

Each binary file, upon initial or subsequent uploading, must meet the following requirements in order to be registered to a service app:

Android™

The service app version and Android API levels must be properly specified in each binary file manifest file:

  • versionCode must be an integer AND higher than the most recent previously uploaded binary file.
  • minSdkVersion must specify the lowest Android API level that the binary file is compatible with AND MUST be greater than 1 AND MUST be less than or equal to the allowed limits.
  • When specified, maxSdkVersion specifies the highest Android API level the binary file is compatible with AND MUST be greater than 1 AND MUST be less than or equal to the allowed limits.
    Note: Android recommends that maxSdkVersion is NOT specified.

Service app binary file registration will fail if any of the requirements are NOT met.

Tizen™ Gear

The Standalone and Companion (Wearable) Gear binary must use the .wgt or .tpk file format.

Companion (Wearable) Gear binary files must include Deeplink information for the Companion (Host) binary files.

The manifest file in the Gear binary file of the Integrated and Linked (Follower) types includes the following meta-information:

<meta-data android:name=" GearAppType" android:value="wgt”/> 
<uses-permission android:name="com.samsung.wmanager.APP"/>

KNOX 1.0

KNOX 1.0 identifier must be included in the Android binary file manifest.

 

If you change a device, you can download a service app with a different binary for the device with the same content/product ID.

Multiple binary files mapped to the same device can be registered with Seller Office, and an end user can download a binary that is compatible with the API level of their device Android OS. Additionally, later versions of a previously registered binary file can be registered.

Additional binary files can be uploaded and registered to a service app when any one of the following criteria are met:

  • The service app versionCode of the binary file being uploaded is equal to or greater than the versionCode of the most recently registered binary file.
  • The compatible API level range of the binary file being uploaded is NOT the same AND is NOT a subset of the range of any registered binary file.
  • At least one of the devices compatible with the binary file being uploaded is different than the devices compatible with ALL currently registered binary files. (The new binary MUST ADD at least one new compatible device.)

In the following scenario, binary B cannot be uploaded and registered:

  • Binary A is registered and its versionCode is 2. The versionCode of binary B is 1.
  • Binary A is registered and supports API Level 7–15. Binary B supports API Level 8–14.
  • Binary A is registered and lists devices 1, 2, and 3. Binary B lists devices 1 and 2. 
  • Was this article helpful?