Troubleshooting

1. UI Layout

To ensure the usability for multiple Galaxy devices regardless of display size:

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

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

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

    e.g. .footer { position: fixed; bottom: 0px; }
  • 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.
  • Investigate
    • Was the UI layout set with proportion (%), not as a fixed size (pixel)?

    • If the layout was set with proportion, was the * { box-sizing: border-box; } property used?

  • Example
    If layout of the original was set to 320x320 but needs to be 360x480, then set the layout using proportion (%).
    • { width: 320px; height: 320px;}
      {width: 320px; height: 320px;}
    • { width: 100%; height: 70%; }
      {width: 100%; height: 70%;}
1-2. Header/Footer
  • Problem
    Unused margin at the top or bottom is displayed.
  • Investigate
    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 do not have proper values.
      .footer { }
1-3. Media elements
  • Problem
    The video is placed off-center in the screen layout.
    Figure 1. Fixed size media element
    Fixed-size media element
  • Investigate
    Check the width and height property settings of the media element to determine whether the percentage and auto keyword are used. These settings are necessary to maintain the size or ratio of the media elements with multiple resolutions.

2. Certificate Key Defects

Certificate Key Defects
Issue Type Troubleshooting
2-1. Certificate
  • Problem
    The .apk file contains two .wgt files.
  • Investigate
    Ensure the .apk file includes only one .wgt. If it has two, remove one.
2-2. SDK default key
  • Problem
    Author signature is invalid. Error: failed to verify the author-signature.xml file.
  • Investigate :
    Check to ensure the SDK default key was used.

3. Functional Defects

Functional Defects
Issue Type Troubleshooting
3-1. Sleep Mode
  • Problem
    The application needed to be on, but it goes into sleep mode when there is no event.
    • Case 1 - Music stops while in sleep mode.

    • Case 2 - Application goes to sleep mode when video or navigation runs.

  • Investigate
    • Case 1 - Check if the Power API was used. If so, set the Power state level as CPU_AWAKE. tizen.power.request("CPU", "CPU_AWAKE");

    • Case 2 - Check if the Power API used. If so, set the Power state level as SCREEN_NORMAL. tizen.power.request("SCREEN", "SCREEN_NORMAL");

3-2. Time Zone
  • Problem
    Time between the Galaxy application and the device is out of sync when the time zone is changed.
  • Investigate
    Use the Tizen Time API, not Date object.
3-3. Galaxy Back Key
  • Problem
    Unable to terminate or return to the previous step by swiping down.
    *Back activity in Galaxy: Swipe downward from the top edge of the screen.
  • Investigate
    Check to see if the app enables the user to go back or terminate the app.

4. Etc.

Etc
Issue Type Troubleshooting
4-1. Sales country
  • Problem
    Galaxy devices tied with Premium Galaxy WVGA and Premium Galaxy WXGA that are supported only in China are selected, but China is not selected as sales country.
  • Investigate
    Determine whether the seller selects China as a sales country when Galaxy - Premium Galaxy WVGA and/or Galaxy - 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 deploy your application to the Galaxy App Store properly:
    • Seller needs to select China as the sales country.
      Or

    • Seller should exclude the Galaxy – Premium Galaxy WXGA device group from supported devices in the Seller Portal if the seller does not want to sell the app in China.

4-2. Testable account
  • Problem
    • Case 1 - Separate account and password needed for login.

    • Case 2 - Credit card information needed for payment verification.

  • Investigate
    • Check if an application needs additional information to verify its functionality.

    • For Case 2, take a video and attach it to Video link for certification review reference filed for verification replacement.

4-3. Galaxy App Type Selection
  • Problem
    An integrated app type should be installed both on the Galaxy and mobile devices, but the app fails to be installed on a mobile device.
  • Investigate
    • Check if the seller selects the correct type of Galaxy app.

    • Integrated types are Android apps (.apk) and Tizen widget (.wgt). The .wgt file has to be put in the Android app’s assets folder.

4-4. Galaxy App Package File Name
  • Problem
    Unable to install the app on the Galaxy device due to invalid app package file name.
  • Investigate
    Check whether there is a space or more than two periods in the Galaxy app package file name. Examples of incorrect file names are:
    • World clock.wgt (space)

    • Stopwatch (1).wgt (space)

    • com.yourapp.wgt (two or more periods)