Android(安卓)Branch deferred deep link 深度链接

Branch 实现Android端 deferred deep link

官网sdk文档地址：https://docs.branch.io/apps/android/
1. Configure Branch（配置Branch）

2. Install Branch

Import the Branch SDK to your build.gradle

    // required for all Android apps    implementation 'io.branch.sdk.android:library:3.+'    // required if your app is in the Google Play Store    implementation 'com.google.android.gms:play-services-appindexing:9.+' // App indexing    implementation 'com.google.android.gms:play-services-ads:9+' // GAID matching

3.Configure app

Add Branch to your AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?><manifest xmlns:android="http://schemas.android.com/apk/res/android"    package="com.eneff.branch.example.android">    <uses-permission android:name="android.permission.INTERNET" />    <application        android:allowBackup="true"        android:name="com.eneff.branch.example.android.CustomApplicationClass"        android:icon="@mipmap/ic_launcher"        android:label="@string/app_name"        android:supportsRtl="true"        android:theme="@style/AppTheme">        <!-- Launcher Activity to handle incoming Branch intents -->        <activity            android:name=".LauncherActivity"            android:launchMode="singleTask"            android:label="@string/app_name"            android:theme="@style/AppTheme.NoActionBar">            <intent-filter>                <action android:name="android.intent.action.MAIN" />                <category android:name="android.intent.category.LAUNCHER" />            </intent-filter>        </activity><activity android:name=".intelsports.ShareShowActivity">        <!-- Branch App Links (optional) -->        <intent-filter android:autoVerify="true">            <action android:name="android.intent.action.VIEW" />            <category android:name="android.intent.category.DEFAULT" />            <category android:name="android.intent.category.BROWSABLE" />            <data android:scheme="olp" android:host="sports.app.link" />        </intent-filter>    </activity>        <!-- Branch init -->        <meta-data android:name="io.branch.sdk.BranchKey" android:value="key_live_kaFuWw8WvY7yn1d9yYiP8gokwqjV0Sw" />        <!-- Branch install referrer tracking (optional) -->        <receiver android:name="io.branch.referral.InstallListener" android:exported="true">            <intent-filter>                <action android:name="com.android.vending.INSTALL_REFERRER" />            </intent-filter>        </receiver>    </application></manifest>

Replace the following with values from your Branch Dashboard App settings and Link settings

example.app.link
key_live_kaFuWw8WvY7yn1d9yYiP8gokwqjV0Sw

以上是Branch的配置信息设置，接下来进行Branch的初始化工作

4.Initialize Branch

Add Branch to your LauncherActivity.java

public class LauncherActivity extends AppCompatActivity {    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_launcher);    }    @Override    public void onStart() {        super.onStart();        // Branch init        Branch.getInstance().initSession(new Branch.BranchReferralInitListener() {            @Override            public void onInitFinished(JSONObject referringParams, BranchError error) {                if (error == null) {                    Log.i("BRANCH SDK", referringParams.toString());                    // Retrieve deeplink keys from 'referringParams' and evaluate the values to determine where to route the user                    // Check '+clicked_branch_link' before deciding whether to use your Branch routing logic                } else {                    Log.i("BRANCH SDK", error.getMessage());                }            }        }, this.getIntent().getData(), this);    }    @Override    public void onNewIntent(Intent intent) {        this.setIntent(intent);    }}

5.Load Branch

Add Branch to your CustomApplicationClass.java

public class CustomApplicationClass extends Application {    @Override    public void onCreate() {        super.onCreate();        // Branch logging for debugging        Branch.enableDebugMode();        // Branch object initialization        Branch.getAutoInstance(this);    }}

6.Test deep link

BranchUniversalObject buo = new BranchUniversalObject();    LinkProperties lp = new LinkProperties()    .addControlParameter("custom1", "data1")    //传入自定义数据    .addControlParameter("custom2", "data2");buo.generateShortUrl(this, lp, new Branch.BranchLinkCreateListener() {    @Override    public void onLinkCreate(String url, BranchError error) {        if (error == null) {            //得到短链接，用于分享            Log.i("BRANCH SDK", "got my Branch link to share: " + url);        }    }});

使用第三方分享或系统自带分享工具，将以上短链接url分享即可。

7.Read deep link(读取depplink中携带的数据)

在要启动的ShareShowActivity或LauncherActivity onStart方法中实现。即可读取出JSONObject中相应数据

// listener (within Main Activity's onStart)Branch.getInstance().initSession(new Branch.BranchReferralInitListener() {    @Override    public void onInitFinished(JSONObject referringParams, BranchError error) {        if (error == null) {            Log.i("BRANCH SDK", referringParams.toString());        } else {            Log.i("BRANCH SDK", error.getMessage());        }    }}, this.getIntent().getData(), this);// latestJSONObject sessionParams = Branch.getInstance().getLatestReferringParams();// first 若设备未安装app，用户安装app后第一次启动即可获取deep link中的数据JSONObject installParams = Branch.getInstance().getFirstReferringParams();

更多相关文章

随机推荐