Bixby Developer Center

References

capsule-info

required

Metadata provided in the capsule-info.bxb file.

This top-level key is defined in your capsule-info.bxb file, which must be in the appropriate locale-specific directory of your capsule. You must have a separate capsule-info.bxb file that contains the required fields for each language you target. For example, if you are supporting both English (en) and Italian (it), you should have a resources/en/capsule-info.bxb file and a resources/it/capsule-info.bxb file (see the example below).

For more information, specifically for which keys are required for Marketplace approval, see the Create Your capsule-info.bxb File topic.

If you have different requirements for a different country, you can override the various keys by creating a capsule-info.bxb file in that more specific folder. For example, you might have a resources/en/capsule-info.bxb file but need to specify a different website-url for the UK. You can have a resources/en-UK/capsule-info.bxb file that just specifies the following:

// resources/en-UK/capsule-info.bxb
// Need a different website URL for UK domain
capsule-info {
...
website-url (https://www.example.co.uk)
}

All the other required information for Marketplace approval is covered by the higher level resources/en/capsule-info.bxb file.

Note

If you are planning to localize your capsule, place any translated information in a separate capsule-info.bxb file under the corresponding resource folder.

Examples

capsule-info {
display-name (Space Resorts)
developer-name (Space Resorts)
icon-asset (/images/bixby-logo.png)
description ("Find and book your next holiday in space")
website-url (https://example.com/)
dispatch-name (Space Resorts)
dispatch-aliases {
alias (SpaceResorts)
}
search-keywords {
keyword (space resorts)
}
requested-permissions {
permission (self:profile){
justification (Your profile information is needed to book a space resort.)
}
}
}

View master on GitHub

// resources/en/capsule-info.bxb
capsule-info {
display-name (Tip Calculator)
description (Calculate the appropriate gratuity for a given service.)
search-keywords {
keyword (tips)
keyword (calculator)
keyword (gratuity)
}
dispatch-name (tip calculator)
dispatch-aliases {
alias (gratuity calculator)
alias (tips calculator)
}
action-bg-color (#FFC50A)
action-fg-color (#443D32)
android-app-id (myActionId)
developer-name (My Awesome Company)
icon-asset (/images/icons/icon.png)
screenshots {
assets (/images/screenshots/screenshot1.jpg)
assets (/images/screenshots/screenshot2.jpg)
assets (/images/screenshots/screenshot3.jpg)
assets (/images/screenshots/screenshot4.jpg)
}
}
capsule-info {
display-name (스페이스 리조트)
developer-name (스페이스 리조트)
icon-asset (/images/bixby-logo.png)
description ("주말에 지낼만한 스페이스 리조트를 예약해보세요")
website-url (https://example.com/)
dispatch-name (스페이스 리조트)
dispatch-aliases {
alias (우주여행)
}
search-keywords {
keyword (스페이스 리조트)
keyword (우주 리조트)
}
requested-permissions {
permission (self:profile){
justification (당신의 프로필 정보는 우주 리조트를 예약하는데 필요합니다.)
}
}
}

View master on GitHub

// resources/it/capsule-info.bxb
capsule-info {
display-name (calcolatore di mance)
description (Calcola la mancia appropriata per un determinato servizio.)
search-keywords {
keyword (suggerimenti)
keyword (mancia)
keyword (gratifica)
}
dispatch-name (calcolatore di mance)
dispatch-aliases {
alias (calcolatrice per suggerimenti)
alias (calcolatrice per la gratuità)
}
action-bg-color (#FFC50A)
action-fg-color (#443D32)
android-app-id (myActionId)
developer-name (La mia compagnia fantastica)
icon-asset (/images/icons/icon.png)
screenshots {
assets (/images/screenshots/screenshot1.jpg)
assets (/images/screenshots/screenshot2.jpg)
assets (/images/screenshots/screenshot3.jpg)
assets (/images/screenshots/screenshot4.jpg)
}
}

Child Keys

action-bg-color
optional
Background color of the action button during a confirmation prompt in mode (Transactional)
action-fg-color
optional
Foreground color of the action button during a confirmation prompt in mode (Transactional)
action-icon-url
optional
This key is not currently used by Bixby
android-app-id
optional
Android application ID
contact-email
optional
This is a beta feature and doesn't yet have documentation
description
optional
Description of the capsule
developer-name
optional
The capsule's developer name that is visible to end-users
dispatch-aliases
optional
Contains alternate names (alias) used for named dispatch
dispatch-name
optional
The primary name for when users interact with your capsule using named dispatch
display-name
optional
The capsule name that is visible to end-users and is displayed in Bixby
exported-permissions
optional
Permissions relevant to sensitive content from an imported library that users will be aware of and asked permission for
icon-asset
optional
Icon that represents the provider or capsule
iconUrl[deprecated]
optional
This key is deprecated
imageUrl[deprecated]
optional
This key is deprecated
name[deprecated]
optional
This key is deprecated
requested-permissions
optional
A block key that describes the reason a permission is being requested from the user
screenshots
optional
Defines the set of screenshot images to include on your capsule's Marketplace page
search-keywords
optional
Defines the set of keywords to use when searching in the Bixby Marketplace
website-url
optional
Website associated with the capsule