Bixby Developer Center

Guides
References

On-Device Testing

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 should test your capsule on an actual Bixby device.

To test on a device, you'll need to:

  • Make a private submission of a capsule to the Bixby Developer Center for testing
  • Enable on-device testing on a compatible device
Caution

While you can use on-device testing with a public submission, you should do all testing with a private submission until you are ready to submit your capsule to the Marketplace.

Check the Troubleshooting page if you have issues with on-device testing.

Testing a Capsule

To test a capsule on a device, the capsule must be prepared using your organization namespace and registered in the Bixby Developer Center (see "Developer Console"). 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.

  1. In Bixby Studio, select Submissions (Cmd+8 / Ctrl+8) to open a submissions tab, then click Create New Submission.

  2. Set the submission type slider to Private. (You can read more about private versus public submissions here.)

  3. Choose the capsule you wish to submit from the list, enter a description for the capsule, and click Submit Capsule.

  4. 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 2019-014-86348 or 2020-014-12053-release.

  5. Use this revision number in the Developer Options screen as described below in Enabling On-Device Testing.

Note

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.

To stop testing a capsule, return to the on-device testing screen in Developer Options and disable testing on the device(s).

Note

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.

If you have a different revision you'd like to test, you can load the revision to your devices.

Enabling On-Device Testing

To enable on-device testing, you must be registered with the Bixby Developer Center. 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.

Bixby Developer Options activated

After activation, go back to the Bixby voice settings screen and tap the now-visible Developer Options. Tap On-device testing. You will be presented with a list of your Bixby-enabled devices that support on-device testing.

Note

Currently on-device testing is limited to the mobile device you are using. This limitation will be removed in a future release.

Device list

Enter the revision number of the private submission of your capsule.

Enter revision number

Bixby will prompt you with a Device Confirmation code. The selected device will give you the same Device Confirmation code as a notification. Tap Confirm to confirm the code.

Device confirmation

At this point, you will be prompted to log into the Samsung Developer Center. After logging in, Bixby will let you know the device has been connected.

Successful login

When you tap on a device enabled for On-Device Testing in the Developer Options device list, you'll see the currently loaded revision number, and have an option to enable or disable testing on that device.

Device enabled for testing