Android Intent学习笔记

这篇博客实际上是学习《第一行代码 Android 第3版》的学习笔记。

Intent是Android程序中各组件之间进行交互的一种重要方式，它不仅可以指明当前组件想要执行的动作，还可以在不同组件之间传递数据。Intent一般可用于启动Activity、启动Service以及发送广播等场景。
Intent大致可以分为两种：显式Intent和隐式Intent。

显式Intent

Intent有多个构造函数的重载，其中一个是Intent(Context packageContext,Class cls)。这个构造函数接收两个参数：

• 第一个参数Context要求提供一个启动Activity的上下文；
• 第二个参数Class用于指定想要启动的目标Activity。

通过这个构造函数就可以构建出Intent的“意图”。接着，Activity类中提供了一个startActivity()方法，专门用于启动Activity，它接收一个Intent参数，这里我们将构建好的Intent传入startActivity()方法就可以启动目标Activity了。

// Kotlin写法
button1.setOnClickListener {
    // 跳转到SecondActivity界面
    val intent = Intent(this, SecondActivity::class.java)
    startActivity(intent)
}

第一个参数传入传入this也就是FirstActivity作为上下文，第二个参数传入SecondActivity::class.java作为目标Activity，这样我们的“意图”就非常明显了，即在FirstActivity的基础上打开SecondActivity。注意，Kotlin中SecondActivity::class.java的写法就相当于Java中SecondActivity.class的写法。接下来再通过startActivity()方法执行这个Intent就可以了。

// Java写法
mBtnTextView.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
        // 跳转到TextView演示界面
        Intent intent = new Intent(MainActivity.this, TextViewActivity.class);
        startActivity(intent);
    }
});

隐式Intent

相比于显式Intent，隐式Intent则含蓄了许多，它并不明确指出想要启动哪一个Activity，而是指定了一系列更为抽象的action和category等信息，然后交由系统去分析这个Intent，并帮我们找出合适的Activity去启动。所谓合适的Activity，简单来说就是可以响应这个隐式Intent的Activity。
通过在标签下配置的内容，可以指定当前Activity能够响应的action和category，打开AndroidManifest.xml，添加如下代码：

<activity
    android:name=".SecondActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="com.example.activitytest.ACTION_START" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

在标签中我们指明了当前Activity可以响应com.example.activitytest.ACTION_START这个action，而标签则包含了一些附加信息，更精确地指明了当前Activity能够响应的Intent中还可能带有的category。只有和中的内容同时匹配Intent中指定的action和category时，这个Activity才能响应该Intent。
修改FirstActivity中按钮的点击事件，代码如下所示：

button1.setOnClickListener {
    val intent = Intent("com.example.activitytest.ACTION_START")
    startActivity(intent)
}

可以看到，我们使用了Intent的另一个构造函数，直接将action的字符串传了进去，表明我们想要启动能够响应com.example.activitytest.ACTION_START这个action的Activity。android.intent.category.DEFAULT是一种默认的category，在调用startActivity()方法的时候会自动将这个category添加到Intent中。
每个Intent中只能指定一个action，但能指定多个category。
修改FirstActivity中按钮的点击事件，代码如下所示：

button1.setOnClickListener {
    val intent = Intent("com.example.activitytest.ACTION_START")
    intent.addCategory("com.example.activitytest.MY_CATEGORY")
    startActivity(intent)
}

如果现在重新运行程序，在FirstActivity界面点击一下Button1，程序会崩溃。原因是没有任何一个Activity可以响应这个Intent。因为在Intent中新增了一个category，而在SecondActivity的标签中没有声明可以响应这个category。所以，我们在中再添加一个category的声明，如下所示：

<activity
    android:name=".SecondActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="com.example.activitytest.ACTION_START" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="com.example.activitytest.MY_CATEGORY" />
    </intent-filter>
</activity>

再次重新运行程序，一切正常。

更多隐式Intent的用法

打开系统浏览器

使用隐式Intent，不仅可以启动自己程序内的Activity，还可以启动其他程序的Activity，这就使多个应用程序之间的功能共享成为了可能。比如你的应用程序中需要展示一个网页，这时你没有必要自己去实现一个浏览器，只需要调用系统的浏览器来打开这个网页就行了。
修改FirstActivity中按钮点击事件的代码，如下所示：

button1.setOnClickListener {
    val intent = Intent(Intent.ACTION_VIEW)
    intent.data = Uri.parse("https://www.baidu.com")
    startActivity(intent)
}

这里我们首先指定了Intent的action是Intent.ACTION_VIEW，这是一个Android系统内置的动作，其常量值为android.intent.action.VIEW。然后通过Uri.parse()方法将一个网址字符串解析成一个Uri对象，再调用Intent的setData()方法将这个Uri对象传递进去。重新运行程序，在FirstActivity界面点击按钮就可以看到打开了系统浏览器。

当然，这里再次使用了前面学习的语法糖，看上去像是给Intent的data属性赋值一样。
setData()方法接收一个Uri对象，主要用于指定当前Intent正在操作的数据，而这些数据通常是以字符串形式传入Uri.parse()方法中解析产生的。

设计一个可以响应https协议的Activity

与此对应，我们还可以在标签中再配置一个标签，用于更精确地指定当前Activity能够响应的数据。标签中主要可以配置以下内容。

• android:scheme。用于指定数据的协议部分，如上例中的https部分。
• android:host。用于指定数据的主机名部分，如上例中的www.baidu.com部分。
• android:port。用于指定数据的端口部分，一般紧随在主机名之后。
• android:path。用于指定主机名和端口之后的部分，如一段网址中跟在域名之后的内容
• android:mimeType。用于指定可以处理的数据类型，允许使用通配符的方式进行指定。

只有当标签中指定的内容和Intent中携带的Data完全一致时，当前Activity才能够响应该Intent。不过，在标签中一般不会指定过多的内容。例如在上面的浏览器示例中，其实只需要指定android:scheme为https，就可以响应所有https协议的Intent了。
我们新建一个ThirdActivity，让它能够响应打开网页的Intent，布局文件命名为third_layout。在AndroidManifest.xml中修改ThirdActivity的注册信息：

<activity
    android:name=".ThirdActivity"
    android:exported="true" >
    <intent-filter tools:ignore="AppLinkUrlError">
        <action android:name="android.intent.action.VIEW"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <data android:scheme="https"/>
    </intent-filter>
</activity>

【注】这里如果直接按照《第一行代码（第三版）》中所给的代码，可能会报两个错：

• [Namespace ‘tools’ not found] 解决方案：在manifest标签中加入xmlns:tools="http://schemas.android.com/tools"
• [Activity supporting ACTION_VIEW is not exported] 解决方案：为当前activity设置android:exported="true"

我们在ThirdActivity的中配置了当前Activity能够响应的action是Intent.ACTION_VIEW的常量值，而category则毫无疑问地指定了默认的category值，另外在标签中，我们通过android:scheme指定了数据的协议必须是https协议，这样ThirdActivity应该就和浏览器一样，能够响应一个打开网页的Intent了。

另外，由于Android Studio认为所有能够响应ACTION_VIEW的Activity都应该加上BROWSABLE的category，否则就会给出一段警告提醒。加上BROWSABLE的category是为了实现deep link功能，和我们目前学习的东西无关，所以这里直接在标签上使用tools:ignore属性将警告忽略即可。

运行程序，点击Button1，系统会自动弹出一个列表，显示了目前能够响应这个Intent的所有程序。

值得一提的是，这里我尝试使用真机（小米8）调试，并没有弹出这个可选的列表，而是直接打开浏览器。目前还不知道是为什么。

其他协议的响应

除了https协议外，我们还可以指定很多其他协议，比如geo表示显示地理位置、tel表示拨打电话。下面的代码展示了如何在我们的程序中调用系统拨号界面。

button1.setOnClickListener {
    val intent = Intent(Intent.ACTION_DIAL)
    intent.data = Uri.parse("tel:10086")
    startActivity(intent)
}

首先指定了Intent的action是Intent.ACTION_DIAL，这又是一个Android系统的内置动作。然后在data部分指定了协议是tel，号码是10086。

向下一个Activity传递数据

到目前为止，我们只是简单地使用Intent来启动一个Activity，其实Intent在启动Activity的时候还可以传递数据。它的思路很简单，Intent中提供了一系列putExtra()方法的重载，可以把我们想要传递的数据暂存在Intent中，在启动另一个Activity后，只需要把这些数据从Intent中取出就可以了。比如说FirstActivity中有一个字符串，现在想把这个字符串传递到SecondActivity中，你就可以这样编写：

button1.setOnClickListener {
    val data = "Hello SecondActivity"
    val intent = Intent(this, SecondActivity::class.java)
    intent.putExtra("extra_data", data)
    startActivity(intent)
}

这里我们还是使用显式Intent的方式来启动SecondActivity，并通过putExtra()方法传递了一个字符串。注意，这里putExtra()方法接收两个参数，第一个参数是键，用于之后从Intent中取值，第二个参数才是真正要传递的数据。
然后在SecondActivity中将传递的数据取出，并打印出来，代码如下所示：

class SecondActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.second_layout)
        val extraData = intent.getStringExtra("extra_data")
        Log.d("SecondActivity", "extra data is $extraData")
    }
}

上述代码中的intent实际上调用的是父类的getIntent()方法，该方法会获取用于启动SecondActivity的Intent，然后调用getStringExtra()方法并传入相应的键值，就可以得到传递的数据了。这里由于我们传递的是字符串，所以使用getStringExtra()方法来获取传递的数据。如果传递的是整型数据，则使用getIntExtra()方法；如果传递的是布尔型数据，则使用getBooleanExtra()方法，以此类推。
重新运行程序，在FirstActivity的界面点击一下按钮会跳转到SecondActivity，查看Logcat打印信息：

返回数据给上一个Activity

Activity类中还有一个用于启动Activity的startActivityForResult()方法，不同于startActivity的是，它期望在Activity销毁的时候能够返回一个结果给上一个Activity。
startActivityForResult()方法接收两个参数：第一个参数还是Intent；第二个参数是请求码，用于在之后的回调中判断数据的来源。我们修改FirstActivity中按钮的点击事件，代码如下所示：

button1.setOnClickListener {
    val intent = Intent(this, SecondActivity::class.java)
    startActivityForResult(intent, 1)
}

这里我们使用了startActivityForResult()方法来启动SecondActivity，请求码只要是一个唯一值即可，这里传入了1。接下来我们在SecondActivity中给按钮注册点击事件，并在点击事件中添加返回数据的逻辑，代码如下所示：

class SecondActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.second_layout)
        val button2: Button = findViewById(R.id.button2)
        button2.setOnClickListener {
            val intent = Intent()
            intent.putExtra("data_return", "Hello FirstActivity")
            setResult(RESULT_OK, intent)
            finish()
        }
    }
}

可以看到，我们还是构建了一个Intent，只不过这个Intent仅仅用于传递数据而已，它没有指定任何的“意图”。紧接着把要传递的数据存放在Intent中，然后调用了setResult()方法。这个方法非常重要，专门用于向上一个Activity返回数据。setResult()方法接收两个参数：

• 第一个参数用于向上一个Activity返回处理结果，一般只使用RESULT_OK或RESULT_CANCELED这两个值；
• 第二个参数则把带有数据的Intent传递回去。

最后调用了finish()方法来销毁当前Activity。由于我们是使用startActivityForResult()方法来启动SecondActivity的，在SecondActivity被销毁之后会回调上一个Activity的onActivityResult()方法，因此我们需要在FirstActivity中重写这个方法来得到返回的数据，如下所示：

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    when(requestCode){
        1 -> if(resultCode == RESULT_OK){
            val returnedData = data?.getStringExtra("data_return")
            Log.d("FirstAcitivity","returned data is $returnedData")
        }
    }
}

onActivityResult()方法带有3个参数：

• 第一个参数requestCode，即我们在启动Activity时传入的请求码；
• 第二个参数resultCode，即我们在返回数据时传入的处理结果（RESULT_OK或RESULT_CANCEL）；
• 第三个参数data，即携带着返回数据的Intent。

由于在一个Activity中有可能调用startActivityForResult()方法去启动很多不同的Activity，每一个Activity返回的数据都会回调到onActivityResult()这个方法中，因此我们首先要做的就是通过检查requestCode的值来判断数据来源。确定数据是从SecondActivity返回的之后，我们再通过resultCode的值来判断处理结果是否成功。最后从data中取值并打印出来，这样就完成了向上一个Activity返回数据的工作。
重新运行程序，在FirstActivity的界面点击按钮会打开SecondActivity，然后在SecondActivity界面点击Button 2按钮会回到FirstActivity，这时查看Logcat的打印信息，如下：

还有一种可能是，用户在SecondActivity中并不是通过点击按钮，而是通过按下Back键回到FirstActivity，这时上面的写法将无法返回数据。我们可以通过在SecondActivity中重写onBackPressed()方法（当用户按下Back键后，就会执行该方法中的代码）来解决这个问题，我们在这里添加返回数据的逻辑即可，代码如下所示（其实就是把button2的点击事件代码copy过来，但这里我加了一句I‘m from BACK以示区分’）：

override fun onBackPressed() {
    val intent = Intent()
    intent.putExtra("data_return", "Hello FirstActivity, I'm from BACK")
    setResult(RESULT_OK, intent)
    finish()
}