Setup

dependencies {  implementation'com.braintreepayments.api:browser-switch:3.3.0'}

dependencies {  implementation'com.braintreepayments.api:browser-switch:3.3.1-SNAPSHOT'}

allprojects {    repositories {        maven {            url'https://oss.sonatype.org/content/repositories/snapshots/'        }    }}

AndroidManifest.xml

<activityandroid:name="com.myapp.MyDeepLinkTargetActivity"android:exported="true">    <intent-filter>        <actionandroid:name="android.intent.action.VIEW"/>        <dataandroid:scheme="my-custom-url-scheme"/>        <categoryandroid:name="android.intent.category.DEFAULT"/>        <categoryandroid:name="android.intent.category.BROWSABLE"/>    </intent-filter></activity>

Usage

val browserSwitchOptions=BrowserSwitchOptions().apply {    requestCode=MY_REQUEST_CODE    url="https://site-to-load.com?callbackURL=my-custom-url-scheme%3A%2F%2Fsuccess"    returnUrlScheme="my-custom-url-scheme"}when (val pendingRequest= browserSwitchClient.start(this, browserSwitchOptions)) {isBrowserSwitchPendingRequest.Started-> {// store pending request    }isBrowserSwitchPendingRequest.Failure-> {// browser was unable to be launched, handle failure    }}

overridefunonResume() {    handleReturnToAppFromBrowser(intent) }funhandleReturnToAppFromBrowser(intent:Intent) {// fetch stored pending request    fetchPendingRequestFromPersistentStorage()?.let { startedRequest->when (val browserSwitchResult= browserSwitchClient.parseResult(startedRequest, intent)) {isBrowserSwitchResult.Success-> {// handle successful browser switch result// clear stored pending request            }isBrowserSwitchResult.NoResult-> {// user did not complete browser switch// allow user to complete browser switch, or clear stored pending request            }        }    }}

Launch Modes

overridefunonNewIntent(newIntent:Intent?) {super.onNewIntent(intent)    handleReturnToAppFromBrowser(intent) }

Versions

Help

License