Skip to main content
Samsung Developer Program

Binary Files, Distribution Devices, and Beta Test Setup

Note: In August 2018, Samsung Gear became Samsung Galaxy Watch. Information referring to Galaxy Watch also applies to earlier Gear devices and apps, unless stated otherwise.

 

How to register, change, and delete binary files, review device compatibility and set distribution devices, and set up beta test releases for your Galaxy Watch apps.

Binary files

A Galaxy Watch app (such as a news or health monitoring app) or a watch face app based on the Tizen platform can be either:

  • Standalone app: operates independently of other apps, and does not need a host app.
  • Companion app: communicates and interacts with a host app running on an Android device.
     

Binary files determine the type of app. After registering an app, you can change the app type by deleting all of its registered binary files of one app type and then adding new binary files of the other app type. You cannot add binary files of different app types to the same app. Changing the Galaxy Watch app type changes the device compatibility information. For more details, see Gear Application Types.

Watch face apps can also be generated by the Galaxy Watch Designer tool. These apps are standalone.

In order to add a Galaxy Watch binary file, ensure they meet the following requirements:

  • Filenames must be unique among all binary files registered to the app. 
  • Filenames must not contain spaces or special characters; however, they can contain underscores. 
  • For more binary file requirements, see Application Binary Files.
     

To register binary files

  1. In Seller Office, navigate to your Galaxy Watch app and click its Binary tab.
    SellerOffice_BinaryTab_Gear.png

     
  2. For each binary file to be added (up to 10):
    1. Click Add binary or Add more binary.
      SellerOffice_BinaryTab_AddBinary_Gear.png

      Caution: After you upload the first binary file when registering a new app, the app will be registered to your Seller Office account, and the app cannot be changed later to another Seller Office account.
       
    2. Enter the required information about the component binary file(s) and upload the files.
    3. Click Save.
    4. For each additional binary file, repeat step 2.
       
  3. At the top of the Binary tab, click Save.
     

To review and manage registered binary files

  1. In Seller Office, navigate to your Galaxy Watch app and click its Binary tab.
    SellerOffice_BinaryTab_Gear.png
     
  2. Review the basic binary file information.
  3. To review detailed information about a registered binary file:

    1. Click the [file ID, version, filename, status icon, or up/down arrow].


      SellerOffice_BinaryTab_BinaryDetails_GalaxyWatch_Companion.png
       
    2. Review the binary file detailed information.

    3. To hide binary file details, click the [file ID, version, filename, status icon, or up/down arrow].
       

  4. To change information about the current version or upload a later version of a registered binary file:
    1. Click the file's [Modify Pencil-icon].
    2. In the Add binary popup, change information and/or upload a binary file. 
      For details see Component binary file information.
       
  5. To permanently remove a registered binary file:
    1. Click the file's [Delete X-icon].
    2. In the Notice popup, click Yes.
       

Device Compatibility and Distribution Devices

You can review which user devices (phone, tablet, and other types of devices) are compatible with each registered app binary file, set compatible devices as distribution devices, and review why other user devices are not compatible.

After registering one or more binary files, all compatible devices are listed and selected (checkmarked). At any time, you can unselect and reselect devices for each registered binary file. You can also determine which features of non-compatible devices are supported and not supported by your registered binary files.

You can control which users can download your app. Your app will not be available for download to users who do not have a distribution device that you specify. When a user does have a distribution device, whether or not they can download your app is also controlled by other factors (including whether the user is in a distribution country that you selected).

You can select your app's distribution devices from among all devices that are compatible with your app's binary files. Different binary files can be compatible with different devices. Device compatibility is determined by the features supported by a device and the Galaxy Watch resolution settings you specified for a binary file.

To manage device compatibility and distribution

  1. Next to Selected Device(s), click the [total number of distribution devices].
    SellerOffice_GalaxyWatchBinary_DetailedDeviceSettings.png
    Note: Upon initial display, the popup shows the current status of each device.
     

  2. To control the devices that are listed, set the following:

    Search Device [Selection type]

     

    Displays devices based on distribution / non-distribution devices:

    • All devices (#) - Both checked and unchecked devices
    • Selected device (#) - Checked, distribution devices
    • Unselected device (#) - Unchecked, non-distribution devices
    Search Device
    [Device title text]
    Only displays devices whose name contains all or part of the entry text.

    Sort Device By

     

    Orders displayed devices by:

    • New - calendar order of device release (new-to-old devices)
    • Name - alphabetical order of device names
    Device Group [Sort arrow] Toggles between top-to-bottom or bottom-to-top based on Sort Device By setting.

     

  3. Review the device compatibility information.

  4. For each binary file, select its distribution devices:
    Note: After a binary file is registered (indicated by the red circle 'N' icon), all devices that are compatible with the binary file are displayed and all devices are checked.
     
    1. To change the distribution status of all listed, compatible devices:
      1. For all binary files, click the [Select All] checkbox.
      2. For each binary file, click the [binary file] checkbox.
         
    2. To change the distribution status of an individual device:
      1. If necessary, open the device type list (Phone, Tablet, Note Gear, Others) by clicking its Down arrow.
      2. For the listed device and the binary file, click the [Binary file / device] checkbox.
        Note: Duplicate devices discovered when verifying app titles cannot be selected.
         
  5. To register all changes and close the popup, click Save.
  6. To not register any changes and close the popup, click Cancel
  7. For non-compatible devices, review the device features that one or more binary files do not support:
    Note: Non-recommended devices are not compatible with a binary file. However, after determining how your binary files are not compatible with non-compatible devices, you can make the necessary changes to make and register binary files that are compatible with more devices.

    1. In the Binary tab, click Non-recommended Device(s).
      SellerOffice_BinaryTab_CheckCompatibility_Gear.png
    2. Select the device and the binary file(s) to be checked:

      [Left field] Type of device
      [Center field] Specific device of the selected type
      Select binary

      Registered binary file(s):

      All - All registered binary files

      Binary (#) - Indicated binary file only

       
      1. Click Confirm.
      2. Review the device feature and resolution compatibility information.

      3. Click Close.
         
  8. To distribute your app to a device group that is non-recommended:

    1. Make the necessary changes to make your app binary file(s) compatible.
    2. Upload the new binary file(s).
    3. Click the number next to Selected Device(s), and in the Detailed Device Settings popup, ensure the device is selected.
       

Beta Testing Setup

You can release your Galaxy app under normal distribution conditions, or under closed beta testing distribution conditions after you set up your beta test.

Closed beta tests allow you to obtain feedback from beta test users to improve the quality and security of the app before it is released for public distribution. Beta test users are not charged for beta test applications. You can register up to 1,000 beta testers who have a Samsung account ID.

If your beta app integrates Gear Watch IAP and offers in-app items, you can control whether they are charged for beta in-app items (to test item purchasing) or they are not changed for beta in-app items. When the beta test is completed, beta in-app items are no longer usable.

 

To set up a closed beta test

  1. In Seller Office, navigate to your Galaxy Watch app and click its Binary tab.
  2. Click Settings under Closed Beta Test.

    SellerOffice_BinaryTab_ClosedBetaTest_GalaxyWatch.png
     
  3. Enter the closed beta test information.

  4. Click Save.
    To release your app under open beta testing conditions, see Android Beta Testing.

 

  • Was this article helpful?