Distributing Application

This guide explains how to distribute a registered TV app.

Distributing to TV Apps Store

When all the app information required for launching the service is registered, it becomes available for distribution on the TV App Store.
After the app is released, we may continue to release upgraded versions with added features or fixed defects.

When a release request is made, a Smart TV model group is selected to service and run the app, and pre-tests matching the entered app information and the selected model group are run, and if there is a problem that cannot be submitted, we will notify you.

The app that has been requested to be released is reviewed by Samsung and tested for verification, which may be rejected during the process. If a defect is found in the app during the verification process, it may not be released.
These issues are reported through the 'Applications > Defect Resolve' menu, and the seller must resolve the issue with the app and resubmit it.

If it passes Samsung's verification test, the app service will start in the Smart TV model group in the service country.

Note

  • App information is fully entered, you can request app release.
  • A new version cannot be released while the app service is stopped. If it is suspended, resume the service first.

Requesting New Release

To release to the TV App Store, click the [Request New Release] button on the 'Applications > Distribute' page.

Figure 1. Request New Release

Figure 1. Request New Release

When the launch request page is provided, first select the app version you want to launch.
If the version you want to release is not listed, click the [Upload App] button to upload the app package file first.

Note

It is not possible to submit a version in the alpha test process, but can be submitted after the test is over.

Select a Smart TV model group to release the selected app version.
In the case of the Tizen .NET app, the service can be released from the TV model group after 2018.

Note

  • Model groups that are still undergoing certification/verification for the previously submitted app version cannot be selected. First you need to cancel the process in progress. For more information, refer to the Verification Drop section of the Changing Application Status guide.
  • Model groups with defects cannot be selected. First you need to fix all the defects. For more information, refer to the Resolving Defect guide.
  • Model groups that have already submitted a version higher than the version you intend to release cannot be selected.
  • You cannot select a model group for which the version you want to release has already been released.
  • You cannot submit to a model group lower than the API version of the app package.
  • If the app has the Samsung Checkout payment function applied, it cannot be submitted to a model group that does not support Samsung Checkout.
  • In order to release an app to a model group subject to FCC regulations, Caption and TTS functions must be supported. Apps that do not support Caption or TTS functions cannot be submitted to model groups subject to FCC regulations. For more information, refer to the Entering App Feature Information section of the Entering Application Information guide.
  • When a new version is released to a model group that is undergoing compatibility testing with new Smart TV devices, the compatibility test conducted by Samsung will be stopped, you have to meet the new specifications yourself. If you would like to submit a version with a resolving compatibility issue, you can submit it through the Compatibility menu after receiving a report of the compatibility defect from Samsung. For more information, refer to the Submitting Compatibility Version section.

Finally, explain what Samsung's testers need to know about the release version, and choose whether to agree to launch the app with minor flaws.
If you agree to this, even if a defect is found in the app during the certification/verification process, Samsung may release it without confirmation from the seller if it is a minor defect. We don't release apps with serious flaws.

If you enter all the information and click the [Next] button, a pre-test for the app information and the selected model group will be executed, and if there is a problem that cannot be submitted, we will notify you.

Note

  • The app title written in the default language and the app title specified in the configuration file of the app package must be the same. For more information, see the Entering App Title and Description section of the Entering Application Information guide.
  • If the Samsung Checkout payment function is applied to the app, the related privilege API must be defined in the app package configuration file, and account information must be registered in the DPI system and a record of testing in-app purchases at least once in a DPI sandbox environment. For more information, see the Entering Billing Information section of the Entering Application Information guide.
  • If the in-app AD feature is applied to the app, the related privilege API must be defined in the app package configuration file. For more information, refer to the In-app AD Information section of the Entering Application Information guide.

If the pre-test fails, the app cannot be submitted. If that fails, review and fix the issue before proceeding with the launch request again.
After passing the pre-test, click the [Done] button to complete the release request, and the status of the version and model group will be 'Submitted'.

In the 'Applications > Distribute > App Service' list, you can check the submitted app version and certification/verification status.

Distributing for Alpha Test

Alpha tests can be conducted by distributing to specific TVs before being released to the TV App Store, and the tested version can be distributed to the TV App Store.

This feature is exclusively available to Partner Sellers and allows you to test on 50 TVs for up to 30 days at a time.

By simply setting the app version and test information to be distributed, you can proceed with the alpha test immediately without a separate approval process.

Note

  • The basic service information of the app must be entered to request an alpha test deployment.
  • Alpha testing cannot be performed while the app service is stopped.

Creating Alpha Test

To start a new alpha test, click the [Create Alpha Test] button on the 'Applications > Distribute' page.

Note

You cannot create a new alpha test while another alpha test is in progress. You can only run one alpha test at a time.

Figure 2. Create Alpha Test

Figure 2. Create Alpha Test

When the alpha test creation page is provided, first select the alpha version you want to distribute for testing. Only the 'Ready to Submit' version that has not been released is available for alpha testing.
If the version you want to distribute is not in the list, click the [Upload App] button to upload the app package file first.

Set the duration of the alpha test. It can be set up to 30 days from the same day.

Click the [Add DUID] button to register the TV's DUID information for alpha test. You can register up to 50.
Alpha tests are available from Smart TVs released after 2020, excluding Chinese TVs.

If there is TV information registered in the 'Membership > Device List' menu, you can select it immediately and add it to the DUID list for alpha test.

Figure 3. Add DUID for Alpha Test

Figure 3. Add DUID for Alpha Test

After entering all the information and clicking the [Done] button, you are ready to start the alpha test, and the status of the version will be 'Alpha Testing'.

In the 'Applications > Distribute > Alpha Test' list, you can check the submitted app version and alpha test progress.

It may take a few minutes for actual distribution, and you can only access the alpha test app and version on the TV with the registered DUID.

Editing Existing Alpha Test

During the alpha test, you can adjust the period or add/delete DUIDs to be tested.
You can also test again with the version of the app that has already been alpha tested.

If you click the [Edit] button on the 'Applications > Distribute > Alpha Test' page, a page where you can modify the alpha test settings is provided.

Figure 4. Edit Alpha Test

Figure 4. Edit Alpha Test

You can advance the end date of an ongoing Alpha test or extend it up to 30 days. An alpha test that has ended can be restarted by setting up to 30 days from the same day.

Note

If you want to change the start date of an ongoing alpha test, simply quit the run and start over.

You can remove the TV by clicking the [Delete] button in the DUID list for alpha test, and you can add the TV by clicking the [Add DUID] button. You can register up to 50.

Edit the information and click the [Done] button to apply it immediately.

Stopping Alpha Test

You can immediately end an alpha test in progress.
If you click the [Close Alpha Test] button on the 'Applications > Distribute > Alpha Test' page, it will be terminated immediately, and the status of the version will be 'Alpha Test Closed'.

Of course, you can also use the [Edit] button to advance the alpha test end date.

Submitting Compatibility Version

Whenever a new Smart TV model is released, Samsung conducts its own compatibility test so that apps that are being serviced in the existing model can be properly serviced in the new model.

This process takes place before the new model group is released to the TV Seller Office, and reports compatibility issues to the Seller that need to be fixed before launching the app on the new model.
These issues can be viewed in the 'Applications > Compatibility Defect' menu, and the Seller must submit a version that fixes the issue.

Samsung goes through this process and releases only apps that are not seriously flawed on the new model.

To submit a version with a resolving compatibility issue, click the [Submit Compatibility Version] button on the 'Applications > Distribute' page.

Note

You cannot submit a new version while the app service is stopped. If it is suspended, resume the service first.

When the page for submitting a compatibility version is provided, first select the version of the app to submit.
If the version you want to submit is not listed, click the [Upload App] button to upload the app package file first.

Note

It is not possible to submit a version in the alpha test process, but can be submitted after the test is over.

Select a new Smart TV model group to release the selected app version.

Note

  • Model groups with defects cannot be selected. First you need to fix all compatibility flaws. For more information, refer to the Resolving Compatibility Defect section of the Resolving Defect guide.
  • Model groups that have already submitted a version higher than the version you intend to release cannot be selected.
  • You cannot select a model group for which the version you want to release has already been released.
  • You cannot submit to a model group lower than the API version of the app package.
  • If the Samsung Checkout payment function is applied to the app, it cannot be submitted to a model group that does not support Samsung Checkout.
  • In order to release an app to a model group subject to FCC regulations, Caption and TTS functions must be supported. Apps that do not support Caption or TTS functions cannot be submitted to model groups subject to FCC regulations. For more information, refer to the Entering App Feature Information section of the Entering Application Information guide.

If you click the [Next] button after selecting the version and model group, the app information and pre-test for the selected model group will be executed, and if there is a problem that cannot be submitted, we will notify you.

Note

  • The app title written in the default language and the app title specified in the configuration file of the app package must be the same. For more information, see the Entering App Title and Description section of the Entering Application Information guide.
  • If the Samsung Checkout payment function is applied to the app, the related privilege API must be defined in the app package configuration file, and account information must be registered in the DPI system and a record of testing in-app purchases at least once in a DPI sandbox environment. For more information, see the Entering Billing Information section of the Entering Application Information guide.
  • If the in-app AD feature is applied to the app, the related privilege API must be defined in the app package configuration file. For more information, refer to the In-app AD Information section of the Entering Application Information guide.

If the pre-test fails, the app cannot be submitted. If that fails, review and fix the issue and resubmit.
After passing the pre-test, click the [Done] button to complete the submission.

In the 'Applications > Distribute > Compatibility' list, you can check the submitted version of your app.