Migrate legacy native setup to V2¶

Overview¶

This guide helps migrate older native Android customizations that relied on flat SDK keys to the current V2 configuration model.

The goal is to keep the same onboarding behavior while relocating presentation data into the right top-level sections.

Migration map¶

Legacy native area	Current destination
`setup.loading.*`	`texts.loading`, `styles`, `setup.logo`, `medias.logo`
`documentSelector.setup.*`	`texts.document[].documentSelector`, `styles`, `medias.logo`, `flowSetup.options.document.captures[].documentSelector.setup`
`tutorial_*` keys	`texts..instructions`, `medias..instructions`, `flowSetup.options.*.setup.instructionsShow`
`captureInfo_`, `_notFoundText`, feedback strings	`texts.document[].capture`, `texts.selfie.capture`, `texts.video.capture`
review button texts	`texts.document[].review`, `texts.selfie.review`
result messages	`texts.processResult`, `setup.success`, `setup.errorModal`, `medias.processResult`
colors, fonts, borders	`styles`

Loading¶

Typical legacy keys:

text
textColor
backgroundColor
progressIndicator.*
logo.show
logo.media

Current layout:

texts.loading.title
texts.loading.subtitle
styles
setup.logo.show
medias.logo

Document selector¶

Typical legacy keys:

title.text
countryChooser.title.text
documentChooser.title.text
documentChooser.buttons.*
countryChooser.picker.*
geolocation

Current layout:

Texts move to texts.document[].documentSelector.
Visual appearance moves to styles.
geolocation stays in documentSelector.setup.
Any logo asset moves to medias.logo.

Document capture¶

Typical legacy keys:

tutorial_show
tutorial_titleText
tutorial_bodyText
tutorial_continueButtonText
documentObverse_notFoundText
documentReverse_notFoundText
capture_backgroundColor

Current layout:

tutorial_show becomes instructionsShow.
Instruction copy moves to texts.document[].instructions.
Capture feedback moves to texts.document[].capture.feedback.
Instruction assets move to medias.document[].instructions.
Visual tokens move to styles.

Selfie and video¶

Typical legacy keys:

passive or active tutorial texts
capture feedback strings
review button labels
stage-specific colors

Current layout:

Selfie copy moves to texts.selfie.*.
Video copy moves to texts.video.*.
Instruction media moves to medias.selfie.instructions and medias.video.instructions.
Appearance moves to styles.

Example¶

Legacy snippet:

{
    "flowSetup": {
        "options": {
            "selfie": {
                "setup": {
                    "tutorial_show": "YES",
                    "tutorial_titleText": "Take a selfie"
                }
            }
        }
    }
}

Migrated snippet:

{
    "flowSetup": {
        "options": {
            "selfie": {
                "setup": {
                    "instructionsShow": true
                }
            }
        }
    },
    "texts": {
        "selfie": {
            "instructions": {
                "passive": {
                    "title": "Take a selfie"
                }
            }
        }
    }
}