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