Bixby Approval Checklist - October 2019 - Public
 Share
The version of the browser you are using is no longer supported. Please upgrade to a supported browser.Dismiss

View only
 
ABCDEFGHIJKLMNOPQRSTUVWXYZAAAB
1
COMMON FAIL POINTS ARE HIGHLIGHTED
Updated November 2019. I will do my best to update this once a month.
2
YouTube Playlist:
https://www.youtube.com/playlist?list=PLE9wDcpAxXg_U7alDWme4gAM-kAPuMwJE
3
Documentation Deployment Checklist:
https://bixbydevelopers.com/dev/docs/dev-guide/developers/deploying
4
capsule.bxbDoneRequiredConsequenceNotesDocumentation
5
versionCAN'T SUBMITMust increment for every public submission.
https://bixbydevelopers.com/dev/docs/dev-guide/developers/deploying.prep-marketplace#update-your-capsulebxb-file
6
store-sections - must have a store sectionFAIL1 most relevant store section. Can be in 2 store sections if justified.
https://bixbydevelopers.com/dev/docs/dev-guide/developers/deploying.prep-marketplace#choose-store-sections
7
8
Capsule Info file. Usually found in resources/en-US. You might need to create your own if it's not in your project directory.
9
capsule-info.bxbDoneRequiredConsequenceNotesDocumentation
10
display-name - must be definedFAILWhat your capsule displays as in the Marketplace.
https://bixbydevelopers.com/dev/docs/dev-guide/developers/deploying.prep-marketplace#create-your-capsule-infobxb-file
11
display-name - can't include "test", "beta", "dev", etc.FAIL"trivia genie test" will be a failhttps://bixbydevelopers.com/dev/docs/reference/type/capsule-info.dispatch-name
12
developer-name - must be definedFAILWhat your capsule displays as your developer name in the Marketplace.https://bixbydevelopers.com/dev/docs/reference/type/capsule-info.developer-name
13
icon-asset - must be definedFAILMust be .png format and 1:1 ratio. Don't use Bixby logo or other major brands without consenthttps://bixbydevelopers.com/dev/docs/reference/type/capsule-info.icon-asset
14
description - must be definedFAILMust accurately describe what your capsule does.https://bixbydevelopers.com/dev/docs/reference/type/capsule-info.description
15
dispatch-name - must be definedFAILAt least two words or a compound word. Words like "The" do not count.https://bixbydevelopers.com/dev/docs/reference/type/capsule-info.dispatch-name
16
dispatch-name - must work with ASRFAIL
Try speaking your dispatch name into the simulator / on-device testing. Bixby must be able to pick it up
https://bixbydevelopers.com/dev/docs/reference/type/capsule-info.dispatch-name
17
dispatch-name - can't be too genericFAILSomething like "trivia game" is too generic but "trivia genie" is finehttps://bixbydevelopers.com/dev/docs/reference/type/capsule-info.dispatch-name
18
dispatch-name - must be uniqueFAILSearch the Marketplace for your dispatch namehttps://bixbydevelopers.com/dev/docs/reference/type/capsule-info.dispatch-name
19
dispatch-name - must be nearly identical to display-name
FAILhttps://bixbydevelopers.com/dev/docs/reference/type/capsule-info.dispatch-name
20
dispatch-name - avoid using homophonesFAIL/WARNINGASR issues.https://www.rhymezone.com/
21
dispatch-aliases - Follows all dispatch-name rulesFAILMany capsules fail in the review process here. Use only if you think you need them.https://bixbydevelopers.com/dev/docs/reference/type/capsule-info.dispatch-aliases
22
dispatch-aliases - Limited use casesFAIL
Mainly for adding/removing the word "the", plural variations, and combining/splitting compound words.
https://bixbydevelopers.com/dev/docs/reference/type/capsule-info.dispatch-aliases
23
dispatch-aliases - No synonymsFAILDon't use dispatch-aliases to replace words with synonyms.https://bixbydevelopers.com/dev/docs/reference/type/capsule-info.dispatch-aliases
24
dispatch-aliases - Not to be used to fix ASR issuesFAILIf you're having ASR issues, the variation is usually too huge for dispatch aliases to account for.https://bixbydevelopers.com/dev/docs/reference/type/capsule-info.dispatch-aliases
25
website-url - must be valid link and relevantFAILIf included, must link to valid and relevant url.https://bixbydevelopers.com/dev/docs/reference/type/capsule-info.website-url
26
terms-url - must be valid link and relevantFAILIf included, must link to valid and relevant url.https://bixbydevelopers.com/dev/docs/reference/type/capsule-info.terms-url
27
privacy-policy-url - must be valid link and relevantFAIL
If included, must link to valid and relevant url. Needed for user-profile-access. Might be required in the future.
https://bixbydevelopers.com/dev/docs/reference/type/capsule-info.privacy-policy-url
28
search-keywords - must be relevantWARNINGRecommended to have some relevant search keywords. 10 max. No "Apple", "Google", "Samsung"https://bixbydevelopers.com/dev/docs/reference/type/capsule-info.search-keywords
29
30
Hints file. Usually found in resources/en-US. You might need to create your own if it's not in your project directory.
31
hints.bxbDoneRequiredConsequenceNotesDocumentation
32
hints - At least 3. Must be properly formattedFAILAll 3 hints are top level utterances and MUST WORK!
https://bixbydevelopers.com/dev/docs/dev-guide/developers/deploying.prep-marketplace#provide-hints-for-bixby
33
hints - work with ASR (AKA voice)FAILMUST WORK WITH VOICE! The user can say the entire hint and ASR should be able to pick it up.
https://bixbydevelopers.com/dev/docs/dev-guide/developers/deploying.prep-marketplace#provide-hints-for-bixby
34
hints - Hint variations must workFAILTest variations of hints with voice. Improper error handling will fail your capsule. Watch Video 3
https://bixbydevelopers.com/dev/docs/dev-guide/developers/deploying.prep-marketplace#provide-hints-for-bixby
35
hints - Error handlingFAILIf errors happen (usually in the variations), handle them correctly! See 3rd video for examples.https://bixbydevelopers.com/dev/docs/sample-capsules/samples/error-handling
36
hints - No spelling or grammar mistakesFAIL
https://bixbydevelopers.com/dev/docs/dev-guide/developers/deploying.prep-marketplace#provide-hints-for-bixby
37
38
UI/UX can fail your capsule! Please make sure you don't violate any of the following rules.
39
UI/UX ChecklistDoneRequiredConsequenceNotesDocumentation
40
Dialog/Persona - don't be another persona/assistantFAILDon't introduce your capsule as Siri, Bob, Jimmy, Lizzy, etc, or any other assistanthttps://bixbydevelopers.com/dev/docs/reference/type/dialog
41
Dialog - don't repeat dialog in the viewFAILUnless you have a good reason, don't repeat the dialog up top in the view below.https://bixbydevelopers.com/dev/docs/reference/type/dialog
42
Dialog - must read text in the dialogFAILDon't put text in the dialog area and have Bixby not read it.https://bixbydevelopers.com/dev/docs/reference/type/dialog
43
Dialog - Put short dialogs in dialog. Long dialogs in views.
FAILAround 400 characters or so, you should put the dialog in the view.https://bixbydevelopers.com/dev/docs/reference/type/dialog
44
Dialog - Don't use defaults like "Here's what I found"FAIL/WARNINGDepending on the situation, you can use the default "Here's what I found". To be safe, don't use it.https://bixbydevelopers.com/dev/docs/reference/type/dialog
45
Tappable Components - must be tappableFAILIf the component has a lightbox and on-click option, it needs to do something on tap.https://bixbydevelopers.com/dev/docs/reference/type/layout.content.section.content
46
Punchout Links - use the correct componentFAILUse an attribution link. Don't use other tappable components to punch out.https://bixbydevelopers.com/dev/docs/reference/type/layout-macro-def.content.attribution-link
47
List Views, Input Views, and Prompts - must allow voice
FAILUse use-input-views-for-selection-list-detail for list views. Train for input views.
https://bixbydevelopers.com/dev/docs/reference/type/capsule.runtime-flags.use-input-views-for-selection-list-detail
48
49
Misc. Here's more stuff that could fail your capsule or just be issued a warning. Most of these are more niche / optional compared to the above! Any of the WARNINGS can result in a fail at our disgression.
50
Misc ChecklistDoneRequiredConsequenceNotesDocumentation
51
Performance - Capsule is not too slowFAIL/WARNING2-3 seconds a response is fine. 6+ is too slow. We may reject if it is too slow.
52
Loading - Variable names should not be exposed to user
WARNING"Looking for VARIABLE...". Use progress dialogs.https://bixbydevelopers.com/dev/docs/reference/ref-topics/dialog-modes.dialog-events#progress-event
53
Spelling and GrammarFAIL/WARNINGBad spelling and grammar could get your capsule rejected. Usually it's just a warning.
54
Capsule Scope - tightly focusedFAILStay in your capsule's lane. For example, "Movie Finder" capsule should not give dinner recipes
55
Conversation Drivers - not too many, not too long, functional
FAILShould not be more than 3-5 words. Don't have too many in a single view (4+). Must work.https://bixbydevelopers.com/dev/docs/reference/type/result-view.conversation-drivers
56
user-profile-access - Don't also use guest-access-allowed
FAILIf you use user-profile-access, don't use guest-access-allowed. Violation of privacy laws.
57
Sample Code - can't be too similar to a sample codeFAIL
Don't just copy and paste a template capsule and submit it. At least put some original content in them!
https://github.com/bixbydevelopers
58
Facts Template and other Tempaltes - Minimum quantity
FAIL
At least 10 facts/jokes with images or 20 facts/jokes without images. At least 10 questions in a quiz template.
https://bixbydevelopers.com/dev/docs/sample-capsules/templates
59
60
Final Step!
61
Final Step!DoneRequiredConsequenceNotesDocumentation
62
Submit your capsule!IN REVIEWMake a public submission in the IDE. Open browser and go to your capsule and submit it for review.
https://bixbydevelopers.com/dev/docs/dev-guide/developers/deploying.can-submission#private-and-public-submissions
63
64
Bixby Capsule Approval Process: Part 1 - How to get your Bixby Capsule into the Marketplace
65
https://youtu.be/dAAWvfXvgb0
66
Bixby Capsule Approval Process: Part 2 - Frequent Rejections - Dispatch Names and Dispatch Aliases
67
https://youtu.be/M3IN71RwkaU
68
Bixby Capsule Approval Process: Part 3 - Frequent Rejections - Hints and Testing ASR
69
https://youtu.be/jJfLO35DNXM
70
Bixby Capsule Approval Process: Part 4 - Frequent Rejections - UI/UX
71
https://youtu.be/6fB72XctNJ8
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
Loading...