Hybrid App Setup - Android SDK (v4)

    Attention

    ハイブリッドアプリの連携のためには、あらかじめAirbridge SDKのインストールおよび設定をする必要があります。

    You can configure the Android SDK to handle Airbridge-related tasks occurring within the in-app website of a hybrid app without modifying the website's code.

    Handle Web SDK Commands with the Android SDK

    The Android SDK can handle the commands related to event transmission, device settings, and user settings carried out by the Web SDK. Configure the Airbridge.setWebInterface function before displaying the website in the web view.

    YOUR_WEB_TOKEN is the Web SDK token. You can find it on the [Settings]>[Tokens] page in the Airbridge dashboard.

    12345678910111213141516171819
    class MainActivity : Activity() {
        
        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
            setContentView(R.layout.activity_main)
            initWebView()
        }
        
        fun initWebView() {
            webView.settings.javaScriptEnabled = true
            webView.settings.domStorageEnabled = true
            
            Airbridge.setWebInterface(webView, "YOUR_WEB_TOKEN")
    
            webView.webChromeClient = WebChromeClient()
            webView.webViewClient =  WebViewClient()
            webView.loadUrl("http://my_company.com/main")
        }
    }

    Add the Airbridge.click function to enable deep links in the web view. The web view does not inherently support deep links. Therefore, the Airbridge.click function must be configured so that the SDK can handle the deep link embedded in the tracking link.

    The Airbridge.click function returns true when the input address is a tracking link. When the app is launched through that address, the onSuccess function is called. If there is no internet connection or a different app is launched, the onFailure function is called.

    When the input address is not a tracking link, the Airbridge.click function returns false , and no further action is executed.

    12345
    fun click(
        trackingLink: String,
        onSuccess: OnSuccess<Unit>? = null,
        onFailure: OnFailure? = null
    ): Boolean

    Implementing WebViewClient#shouldOverrideUrlLoading in the WebViewClient allows you to determine whether to continue or cancel loading a specific URL after it is detected. For more information, refer to the Android Developer Guide.

    123456789101112131415161718
    private val webViewClient = object : WebViewClient() {
    
        override fun shouldOverrideUrlLoading(view: WebView?, url: String?): Boolean {
            return super.shouldOverrideUrlLoading(view, url)
        }
    
        @RequiresApi(Build.VERSION_CODES.N)
        override fun shouldOverrideUrlLoading(
            view: WebView?,
            request: WebResourceRequest?
        ): Boolean {
            return super.shouldOverrideUrlLoading(view, request)
        }
    }
    
    private fun initWebview() {
        webView.webViewClient = webViewClient
    }

    During loading, if the specific URL is an Airbridge tracking link, you can use the Airbridge.click function to send the webView#shouldOverrideUrlLoading result as true. This allows the Airbridge Android SDK to open the tracking link instead of the web view.

    The URL host of Airbridge tracking links are abr.ge, YOUR_APP_NAME.airbridge.io, or a custom domain.

    12345678910111213141516171819202122232425262728293031323334
    private val webViewClient = object : WebViewClient() {
    
        private fun handleDomain(view: WebView, uri: Uri): Boolean =
            // return true when uri is tracking link
            // return false when uri is not tracking link
            Airbridge.click(uri.toString(), {
                // on success
                // do nothing
            }, {
                // on failure
                // when uri is another app's tracking link or sdk fails to open uri
                view.loadUrl(uri.toString())
            })
    
        override fun shouldOverrideUrlLoading(view: WebView?, url: String?): Boolean {
            if (view === null) return false
            if (url == null) return false
    
            val uri = Uri.parse(url) ?: return false
            return handleDomain(view, uri)
        }
    
        @RequiresApi(Build.VERSION_CODES.N)
        override fun shouldOverrideUrlLoading(
            view: WebView?,
            request: WebResourceRequest?
        ): Boolean {
            if (view === null) return false
    
            val uri = request?.url ?: return false
            return handleDomain(view, uri)
        }
    }
    

    Attention

    このページは役に立ちましたか?

    ご質問やご提案はありますか?