Bixby Developer Studio includes a simulator that lets you simulate your capsule's behavior on many devices. However, before submitting a capsule to the Marketplace, you may want to test your capsule on an actual Bixby device.
To test on a device, you'll need to:
On-device testing is currently supported only on mobile devices (
bixby-mobile targets) running Bixby 2.0 or higher.
To enable on-device testing, you must be registered with the Bixby Developer Center already. If you haven't registered with the Developer Center, create a Samsung Account first. (This is the same account you use to log into Bixby Studio.)
Enable the Developer Options button in Bixby's settings. This is a hidden feature. To enable it, open Bixby, go to Bixby's Settings, and tap "About Bixby Voice." On the About screen, tap the Bixby version number five times. Bixby will inform you that developer options have been activated.
Go back to the Bixby voice settings screen and tap the now-visible Developer Options button. The first time you do this, you are prompted to log into the Bixby Developer Center on the phone.
After you've logged in to the Bixby Developer Center, Developer Options will be enabled. Tap On-Device Testing on the Developer Options screen to access the on-device testing options.
To test a capsule on a device, the capsule must be prepared using your organization namespace and registered in the Bixby Developer Center (see "Managing Teams & Capsule Access"). If you are testing one of the Sample Capsules, you need to change the
id in the
capsule.bxb file from
example to your organization namespace. Capsules are uploaded from your computer to the Developer Center and downloaded to your testing device.
In Bixby Studio, select Submissions (Cmd+8 / Ctrl+8) to open a submissions tab, then click Create New Submission.
Set the submission type slider to Private. (You can read more about private versus public submissions here.)
Choose the capsule you wish to submit from the list, enter a description for the capsule, and click Submit Capsule.
If you submit multiple capsules as part of your private submission, you will only be able to test each capsule on-device using named dispatch.
After the submission is processed, open its entry in the Submission History list and copy down its revision ID. This will be a number like
On the testing device, go to the on-device testing screen in Developer Options and select Apply Capsule Revision ID. Enter the revision ID from the previous step and tap Apply.
The capsule will be loaded onto the device for testing. When Bixby displays the results from the capsule, the revision ID will appear in the upper right corner of Bixby's views.
To stop testing a capsule, return to the on-device testing screen in Developer Options and turn the on-device testing option to Off.
Be aware that on-device testing allows you to test your specific capsule in isolation. It will not let you test for cross-capsule ambiguities and interactions. Plan to develop and test your capsule independently.