Troubleshooting

1. UI Layout

To ensure the usability for multiple Gear devices regardless of display size,

  • Tip 1. Set target size of content area in the <viewport> meta tag.

    e.g. <meta name="viewport" content="width=320">
  • Tip 2. Set the width and height of each element of all content as a percentage, not as a pixel.

    e.g. {width : 100%; height : 70%}
  • Tip 3. Set the place of the header and footer areas clearly.

    e.g. .footer { position: fixed; bottom: 0px; }
  • Tip 4. Set the width and height properties of the Media element with percentage and the auto keyword.

    e.g. .video iframe { width : 100%; height : auto; }
UI Layout
Issue Type Troubleshooting
1-1. Flexible layout
  • Problem :
    An empty white space at the bottom is displayed.
  • Check Points :
    Was UI layout set with proportion(%) not as a fixed size(pixel)?
    If layout is set with proportion, * { box-sizing: border-box; } property used?
  • Example :
    If layout of original one set to 320 X 320, but it needs to be shown to 360 X 480, then set the layout with proportion(%).
    • { width: 320px; height: 320px;}
      { width: 320px; height: 320px;}
    • { width: 100%; height: 70%; }
      { width: 100%; height: 70%; }
  • Reference:
    Relative Layout item in the 'How to design apps on Tizen Wearable devices with Multi resolution.pdf' http://developer.samsung.com/technical-doc/view.do?v=T000000164
1-2. Header/Footer
  • Problem:
    Unused margin at the top or bottom displayed.
  • Check Points:
    Check the position property definition of Header or Footer whether it is fixed the bottom property as 0 x.
  • Example
    • Footer properties are defined properly.
      Footer properties are defined properly.
      .footer { position: fixed; bottom: 0px; }
    • Footer properties are not defined or don’t have proper values.
      Footer properties are not defined or don’t have proper values.
      .footer { }
  • Reference:
    Header and Footer position item in the 'How to design apps on Tizen Wearable devices with Multi resolution.pdf'
    http://developer.samsung.com/technical-doc/view.do?v=T000000164
1-3. Media elements
  • Problem:
    The video is placed aside on the whole screen layout inharmoniously.
    Figure 1. Fixed size media element
    Figure 1. Fixed size media element
  • Check Points:
    Check the setting of width and height properties of the media element whether the percentage and auto keyword are used when you want to keep the size or ratio of the media elements on the multiple resolution.
  • Reference:
    Flexible Media item in the 'How to design apps on Tizen Wearable devices with Multi resolution.pdf'
    http://developer.samsung.com/technical-doc/view.do?v=T000000164

2. Defects Based on the Different Specifications of the Gear Devices.

Defects Based on the Different Specifications of the Gear Devices
Issue Type Troubleshooting
2-1. Camera Function
  • Problem :
    Camera function does not work properly on the Gear S and Gear 2 Neo devices.
    (Gear S and Gear 2 Neo don’t have camera feature in it.)
  • Check Points :
    If app uses the camera function, is the camera feature key declared in the config.xml file?
    Then unsuitable devices (Gear S and Gear 2 Neo) will not be automatically suggested in the supported devices when seller registers the app on the seller office.
    <tizen:feature name="http://tizen.org/feature/camera"/> :
    If app uses the camera function, are Gear S and Gear 2 Neo devices excluded from the supported devices list on the submission page in the seller office?
  • Reference:
    1.HELP > Tizen IDE > Tizen Wearable Web App Programming > API References > Supplementary API Reference > Find the Camera API specification and description.
    2. HELP > Tizen IDE > Tizen Wearable Web App Programming > API References > Related Pages > Required Feature > W3C/HTML
2-2. GPS function
  • Problem :
    GPS function does not work properly on the Gear 2 and Gear 2 Neo devices.
    (Gear 2 and Gear 2 Neo don’t have GPS feature in it.)
  • Check Points :
    If app uses the GPS function, is the GPS feature key declared in the config.xml file?
    Then unsuitable devices(Gear 2 and Gear 2 Neo) will not be automatically suggested in the supported devices when seller registers the app on the seller office.
    > <Feature Name="http://tizen.org/feature/GPS"/>
  • Reference:
    Tizen Wearable SDK.
    1. Tizen Wearable Web App Programming > Application Development Process > Creating the Application Project > Setting Widget Configuration
    2. Tizen Wearable Web App Programming > API References > Related Pages > Required Feature.
2-3. Telephony
  • Problem :
    GPS function does not work properly on the Gear 2 and Gear 2 Neo devices.
    (Gear 2 and Gear 2 Neo don’t have GPS feature in it.)
  • Check Points :
    If app uses the GPS function, is the GPS feature key declared in the config.xml file?
    Then unsuitable devices(Gear 2 and Gear 2 Neo) will not be automatically suggested in the supported devices when seller registers the app on the seller office.
    <Feature Name="http://tizen.org/feature/network.telephony"/>
  • Reference:
    Tizen Wearable SDK.
    1. Tizen Wearable Web App Programming > Application Development Process > Creating the Application Project > Setting Widget Configuration
    2. Tizen Wearable Web App Programming > API References > Related Pages > Required Feature.
    Don’t forget to identify the features you made use of.

3. Certificate Key Defects

Certificate Key Defects
Issue Type Troubleshooting
3-1. Certificate
  • Problem :
    apk contains two more wgt.files in it.
  • Check Points :
    Check if apk has only one wgt.file in it.
3-2. SDK default Key
  • Problem :
    Author signature is invalid. Error: failed to verify file "author-signature.xml"
  • Check Points :
    Check if the SDK default key was used.
  • Reference:
    To publish developer own key should be used with Registration file.
    For more information, IDE > Help Contents > Generating a certificate request.
    Or, Help Contents > Getting Started with Tizen wearable > Development Environment > Tizen SDK for wearable > Certificate.

4. Functional Defects

Functional Defects
Issue Type Troubleshooting
4-1. Sleep Mode
  • Problem :
    Application needed to be on gets into Sleep mode when there is no event.
    [Case1] Music stops while on the Sleep mode.
    [Case2] Application goes to Sleep mode when Video/Navigating runs.
  • Check Points :
    [Case 1] Check Power API used ; Power state level should be set as CPU_AWAKE. tizen.power.request("CPU", "CPU_AWAKE");
    : [Case 2] Check Power API used; Power state level should be set as SCREEN_NORMAL. tizen.power.request("SCREEN", "SCREEN_NORMAL");
  • Reference :
    Check Power API from Tizen Wearable Web app programming when you want to control the sleep mode.
    • Tizen Wearable Web App Programming > Programming Guide > Device API Guides > System Guides > Power: Accessing the Device Power Resource.

    • Tizen Wearable Web App Programming > Tutorials > Device API Tutorials > System Tutorials > Power Tutorial

4-2. Time Zone
  • Problem :
    Time is out of sync between Gear and device when Time zone is changed.
  • Check Points :
    Check if Tizen Time API is used, not Date object.
  • Reference:
    http://developer.samsung.com/faq/view.do?v=F000000037
    Tizen Wearable Web App Programming > API References > Device API Reference > System > Time API
4-3. Gear Back Key
  • Problem :
    Unable to terminate, or return to the previous step by Swipe down.
    *Back activity in gear : Swiping downwards from the top edge of the screen.
  • Check Points :
    Check if app enables user to go back or terminate app.
  • Reference:
    Samsung GearS_UI Design Guideline 1.4.2 Bezel Swipe Down(back)
    http://developer.samsung.com/technical-doc/view.do?v=T000000184

5. Etc.

Etc
Issue Type Troubleshooting
5-1. Sales country
  • Problem :
    Gear devices tied with Premium Galaxy(WVGA) and Premium Galaxy(WXGA) that supported only in China are selected, but China is not selected as sales country.
  • Check Points :
    Check if seller selects China as sales country when 'Gear - Premium Galaxy(WVGA)' and/or 'Gear - Premium Galaxy (WXGA) device groups are selected.
    • Gear BT only - Premium Galaxy (WVGA)

    • Gear Standalone - Premium Galaxy (WVGA)

    • Android Gear BT only - Premium Galaxy (WXGA)

    • Gear BT only - Premium Galaxy (WXGA)

    • Gear Standalone - Premium Galaxy (WXGA)

  • To service your application to the GALAXY Apps properly,
    1) Seller needs to select the China as sales country.
    Or
    2) Seller should exclude 'Gear –Premium Galaxy(WXGA)' device group from supported devices on the seller office when seller doesn't want to service the app to China.
5-2. Testable account
  • Problem :
    Extra information for testing is not provided.
    [Case 1] Separate account and password needed for log-in.
    [Case 2] Credit cards information needed for payment verification.
  • Check Points :
    Check if applications needs extra information for its functionality verification.
    For Case 2, take a video and attach it on 'Video link for certification review reference' filed for verification replacement.
  • Reference:
    'Video link for certification review reference', 'Comments to Certification' fields among app registration fields on Seller Site.
5-3. Gear App Type Selection
  • Problem :
    An integrated type should be installed both on Gear and Mobile, but it fails to be installed on Mobile device.
  • Check Points :
    Check if seller selects right type of Gear app.
    Integrated type comprises of android app(.apk) & tizen widget(.wgt).
    .wgt file has to be put in assets folder of android app(.apk).
  • Reference:
    Gear App Submission Guideline on Seller Site.
5-4. Gear App Package File Name
  • Problem :
    Unable to install the app on the Gear device due to invalid app package file name.
  • Check Points :
    Check if there is a space('') or more than two periods('.') in the Gear app package file name.
    [Wrong file name form 1 related with Space] 'World clock.wgt'
    [Wrong file name form 2 related with Space] 'Stopwatch (1).wgt'
    [Wrong file name form 3 related with two more periods as a path separator]

    'com.yourapp.wgt'