2020-12-06

Jetpack DeepLink

1.DeepLink 详解

---

文章目录

• Jetpack DeepLink
• 前言
• Navigation 参数
• • URI 参数说明
  • mimeType 类型说明
  • Action参数
• 下面给一个完整的DeepLink给如何配置的例子
• 总结

---

---

前言

主要说明Navigation DeepLink的源代码，看如下过程的现实
1:DeepLink 三个参数详解 ,
2:DeepLink 参数解析过程 ,
3:Navgation导航目标生成过程 ,
4:Navgation如何现实导航到指定目标的,

---

Navigation 参数

    <declare-styleable name="NavDeepLink">
        <attr format="string" name="uri"/>
        <attr format="string" name="action"/>
        <attr format="string" name="mimeType"/>
        <attr name="android:autoVerify"/>
    </declare-styleable>

URI 参数说明

URI参考资料

https://tools.ietf.org/html/rfc3986
https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web

URI格式介绍

1. Scheme://Authority:Port/Path?Query#Fragment

完整URI链接:

2.http://www.example.com:80/path/to/myfile.html?
key1=value1&key2=value2#SomewhereInTheDocument

对应关系:

Scheme ->http
Authority->www.example.com
80->port
Path->/path/to/myfile.html
Query->key1=value1&key2=value2
Fragment->SomewhereInTheDocument

URI标准scheme说明描述

Scheme	Description
data	Data URIs
file	Host-specific file names
ftp	File Transfer Protocol
http/https	Hyper text transfer protocol (Secure)
javascript	URL-embedded JavaScript code
mailto	Electronic mail address
ssh	Secure shell
tel	telephone
urn	Uniform Resource Names
view-source	Source code of the resource
ws/wss	WebSocket connections (Secure)

mimeType 类型说明

mime全称

 Mine:什么是 Multipurpose Internet Mail Extensions 

参考资料

https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types

例子

类型	描述	典型示例
text	表明文件是普通文本，	理论上是人类可读 text/plain, text/html, text/css, text/javascript
image	表明是某种图像。不包括视频，但是动态图（比如动态gif）也使用image类型	image/gif, image/png, image/jpeg, image/bmp, image/webp, image/x-icon, image/vnd.microsoft.icon
audio	表明是某种音频文件	audio/midi, audio/mpeg, audio/webm, audio/ogg, audio/wav
video	表明是某种视频文件	video/webm, video/ogg
application	表明是某种二进制数据	application/octet-stream, application/pkcs12, application/vnd.mspowerpoint, application/xhtml+xml, application/xml, application/pdf

Action参数

Google官方描述:

操作的名称。某些标准操作在 Intent 类中定义为 ACTION_string 常量。要将其中一项操作分配给此属性，请在 ACTION_ 后跟的 string 前面加上“android.intent.action.”。例如，对于 ACTION_MAIN，请使用“android.intent.action.MAIN”；对于 ACTION_WEB_SEARCH，请使用“android.intent.action.WEB_SEARCH”。
对于您定义的操作，最好将应用的软件包名称用作前缀，以确保唯一性
例如:
可按如下方式指定 TRANSMOGRIFY 操作：
<action android:name="com.example.project.TRANSMOGRIFY" />

navigation action参数应该怎么写

  <fragment android:id="@+id/loan_main"
        android:name="com.hc.load.LoanMainFragment"
        tools:layout="@layout/fragment_loan_input_money_layout" >
        <deepLink
            android:id="@+id/deepLink"
            app:action="${applicationId}.LoanMainFragment"
          	/>
  </fragment>

为什么这样写，最后解析的结果是什么

• 1.下面这段代码中是在NavInflater解析src/main/res/navigation/xxx.xml一段代码。
• 2.这段代码主要解析的就是我们要将的DeepLink参数部分。
• APPLICATION_ID_PLACEHOLDER的值就是"${applicationId}" ，如果我们的参数中包含
  这个"${applicationId}"那么会被直接替换成包名。’
• 前面讲过为什么使用包名，主要是保证唯一性。

 private void inflateDeepLink(@NonNull Resources res, @NonNull NavDestination dest, @NonNull AttributeSet attrs) throws XmlPullParserException {
        final TypedArray a = res.obtainAttributes(attrs, R.styleable.NavDeepLink);
        String uri = a.getString(R.styleable.NavDeepLink_uri);
        String action = a.getString(R.styleable.NavDeepLink_action);
        String mimeType = a.getString(R.styleable.NavDeepLink_mimeType);
        if (TextUtils.isEmpty(uri) && TextUtils.isEmpty(action) && TextUtils.isEmpty(mimeType)) {
            throw new XmlPullParserException("Every <" + TAG_DEEP_LINK
                    + "> must include at least one of app:uri, app:action, or app:mimeType");
        }
        NavDeepLink.Builder builder = new NavDeepLink.Builder();
        if (uri != null) {
            builder.setUriPattern(uri.replace(APPLICATION_ID_PLACEHOLDER,
                    mContext.getPackageName()));
        }
        if (!TextUtils.isEmpty(action)) {
            builder.setAction(action.replace(APPLICATION_ID_PLACEHOLDER,
                    mContext.getPackageName()));
        }
        if (mimeType != null) {
            builder.setMimeType(mimeType.replace(APPLICATION_ID_PLACEHOLDER,
                    mContext.getPackageName()));
        }
        dest.addDeepLink(builder.build());
        a.recycle();
    }

下面给一个完整的DeepLink给如何配置的例子

1.例子
2.源代码解读。
3.常用方式。
1.参数传递

总结

今天先到这里，明天继续

本文地址：https://blog.csdn.net/shaohuazuo/article/details/110784840