FAQ

You must specify in Seller Portal that your binary is compatible with all new devices (a watch with an upgraded OS is considered a new device) and republish your app. After your updated app is published, it will be available to those new devices.

On Gear S3 and Gear Sport watches, the Tizen OS can be upgraded. Gear S3 can be upgraded from Tizen 2.3 to Tizen 3.1 or 4.0.0.1. Gear Sport can be upgraded from Tizen 3.0 to Tizen 4.0.0.1.

If you published your app before these upgrades were available, the option to include the upgraded watch as a compatible device was not available in Seller Portal. For example, if you published your app before Tizen 4.0.0.1 was released, your selections for compatible Gear Sport watches in Seller Portal would have been for Tizen 3.0 only. Likewise, your selections for compatible Gear S3 devices would have been for Tizen 2.3 and 3.0. As a result, a customer who has upgraded their watch to Tizen 4.0.0.1 will not be able to view your app in the Galaxy Store.

In order to have your watch app recognized as compatible with an upgraded watch, you must update the compatible devices for the binary in Seller Portal. In general, if a new device is released or an existing device becomes upgradable to a new OS after you have published your app and you want your app available on these devices, you must update your binary to be compatible with these devices and republish your app.

To update the list of compatible devices for your binary file in Seller Portal:

  1. Log in to Seller Portal and open your watch face app.

  2. Click the Binary tab.

  3. At the top of the Binary section, in the middle is a box with Selected Device(s) and the total number of selected compatible devices. Click on the number.

  4. In the Detailed Device Settings window, select each device with which the binary is compatible. If your binary is compatible with all listed devices, click Select All.

  5. Click Save.

  6. Submit your app for validation and, after it has been successfully validated, republish it.

Make your Galaxy Watch face or app stand out in the Galaxy Store.

Samsung recommends that you use portrait-orientation product images for your Galaxy Watch detail page. Users can just tap on a portrait image to open it in full-screen mode, creating an optimal phone experience and allowing your app to stand out in the Galaxy Store.

Best practices

  • Use detailed, close-up images of the product. We suggest that you use just the product and logo (with minimal or no text) for a strong image that shows the quality of your workmanship.

  • Avoid using identical images for the icon, cover image, and screenshot. In this case, the detail page shows three duplicate images rather than three separate views of the product.

Screenshot resolution

We suggest the following resolution guidelines for screenshots:

  • Cover Image = 1024 x 500 pixels
  • Horizontal Screenshots = 1500 x 750 pixels
  • Vertical Screenshots = 550 x 1100 pixels

Galaxy Store Asset Creator

You can use the Galaxy Store Asset Creator to easily export the assets you need to publish your watch face to the Galaxy Store. To use this tool, you need:

  • Photoshop version 16.0 (CC 2015) or later
  • A basic understanding of Photoshop.

Download the Galaxy Store Watch Asset Creator template to get started!

Lifestyle Photo Asset Packs

Show off your watch face designs on an actual watch using our "Smart" Photoshop files.

Download Lifestyle Photo Asset Packs and save time!

Examples

The following screenshot shows a Galaxy Watch detail page with three portrait screenshots that show detailed aspects of the Galaxy Watch face:

The following screenshot shows a Galaxy Watch detail page with landscape screenshots that are cut off on the sides, making them less visually appealing in the Galaxy Store:

Use the Lifestyle Photo Asset Packs to show your watch face designs on an actual watch. Or, use the Galaxy Store Asset Creator to easily export the assets you need to publish your watch face to the Galaxy Store. To use these tools, you need:

You can use Galaxy Watch Studio (formerly Galaxy Watch Designer) to design your Galaxy Watch faces.

To download Galaxy Watch Studio (GWS), go to https://developer.samsung.com/galaxy-watch-design/studio/overview.html.

To develop watch faces using GWS, see the Galaxy Watch Studio tutorial.

The distributor certificate is used for signing and verifying your app. It identifies the distributor (for example, Galaxy Store) and grants privileges to that distributor. For testing purposes, it ensures that your signed application is installed on registered devices only.

In order to test your app on a device, the device must be registered in your personal distributor certificate. Then, you must build your app, which signs the app using your personal distributor certificate.

To generate a personal distributor certificate and register a Samsung device,

  • Using the Galaxy Watch Studio (formerly Galaxy Watch Designer), from the main menu bar, click Project > Distribute Certificate. For more information, see Get Your Certificates.
  • Using Tizen Studio, from the main menu bar, click Tizen Tools > Certificate Manager (the Samsung Certificate Extension must be installed in order to properly generate a personal distributor certificate for your Samsung device). For information about the Samsung Certificate Extension, see Installing Certificate Extension. For information about the Certificate Manager, see Creating Certificates and Managing Certificate Profile.

The personal distributor certificate is used for testing only. When you release your app for sale in the Galaxy Store, your personal distributor certificate is replaced by an official distributor certificate.

If you upgrade a registered device (for example, you upgrade the Tizen OS), you may need to re-register the device in your personal distributor certificate. For example, if you upgrade your Galaxy Watch 3 or Sport watch to Tizen 4.0, you must re- register the device in your personal distributor certificate and rebuild your app before testing it on the device.

You may encounter one of the following error messages if there is a problem with the distributor certificate:

Message Message Solution
Account in device profile mismatch with distributor certificate. The device has been upgraded and the DUID (Device Unique Identifier) has changed. Re-register the device in your personal distributor certificate and rebuild your app.
Launching AppManagerAppID has encountered a problem. The device is not found in your personal distributor certificate or your personal distributor certificate was not created properly. Register the device in your personal distributor certificate or re-create your personal distributor certificate and rebuild your app.
The application installation on the device has failed due to a signature error! (error code : -12) You used the Tizen Studio distributor certificate when building your app, not the distributor certificate generated by the Samsung Certificate Extension. Select or create a distributor certificate for your Samsung device using the Certificate Manager and rebuild your app.
For information about the Samsung Certificate Extension, see Installing Certificate Extension.
For information about the Certificate Manager, see Creating Certificates and Managing Certificate Profile.

For more information about distributor certificates, see Getting the Certificates.

You can register up to 50 devices to one Samsung certificate.

http://developer.samsung.com/galaxy-watch/develop/getting-certificates/create

Developer certificate is made of Author certificate and Distributor Certificate.

To change or add a new device to the certificate, you need to create a new Distributor Certificate again while keeping the same Author Certificate. For more information, please see the link below.

http://developer.samsung.com/galaxy-watch/develop/getting-certificates/manage

Linking to Galaxy App store:

Use the format below to deeplink directly to an app’s detail page, where users can see App description, screen shots etc and then install it. To create a link, you need to know app’s fully qualified package name which is declared in Android manifest file (for android app) or config.xml / tizen manifest file (for Galaxy Watch app).

From a Galaxy Watch App to Android app’s store detail page:

samsungapps://ProductDetail/ Example, samsungapps://ProductDetail/com.example.androidapp

From a Galaxy Watch App to Galaxy Watch app’s store detail page:

samsungapps://ProductDetail/ Example, samsungapps://ProductDetail/cNAm8uGvZ8

From a web site:

http://apps.samsung.com/gear/appDetail.as?appId= Example, http://apps.samsung.com/gear/appDetail.as?appId=cNAm8uGvZ8

You can download the latest version of TAU library: https://developer.tizen.org/development/guides/web-application/tizen-advanced-ui/downloading-tau

http://img-developer.samsung.com/onlinedocs/gear/Extension_PG_Web/html/prog_guide/remote_ww.htm

For example:

    function test() {
    var now = new Date();
    console.log("hour:"+now.getHours()); // Even when the time zone is changed, it remains unchanged
    }
    setInterval(function(){test();}, 1000);

To solve the problem, use the Tizen Time APIs instead of the Date object:

   var now = tizen.time.getCurrentDateTime(); or var now = new tizen.TZDate(); 

In wearable Web applications, use the following APIs to receive notifications of time changes (including time zone changes):

    void setDateTimeChangeListener (SuccessCallback changeCallback)
    void unsetDateTimeChangeListener ()

For more information, see Time API

See Testing your App on Galaxy Watch

If your device is Galaxy Watch S or older, there are 2 ways of transferring your application(.wgt) to Galaxy Watch device.

First way is, Create an android application -> copy your .wgt file to assets folder of the android application -> generate apk -> install this apk through Galaxy Watch manager to your Galaxy Watch device. Second way is, go to command prompt -> go to the directory where the sdb.exe tool is located -> make sure your .wgt file is in this directory -> type command: sdb install .wgt.

From the Galaxy Watch S2 with Tizen 2.3.1 the integrated and linked type were deprecated and only supported for the old models like Galaxy Watch 2 and Galaxy Watch S. See this video.

Yes.

No. It is available from the Galaxy Watch S2 based on the Tizen 2.3.1.

No, it is not necessary to create a Galaxy Watch app to send notifications from your phone. Every notification that the phone receives is automatically relayed to your Galaxy Watch device after you enable this functionality in Samsung Galaxy Watch settings.

Yes, more information can be found at http://developer.samsung.com/remotetestlab/rtlAboutRTL.action

http://developer.samsung.com/galaxy-watch/develop/creating-your-first-app/web-companion/configuration

No, it is not supported as of now, only host device to wearable emulator connectivity is supported.

http://developer.samsung.com/galaxy-watch/develop/creating-your-first-app