安卓ComponentName简介及使用

目录

• 一、ComponentName是什么？
• 二、类分析
• • [2.1 构造方法](#2.1 构造方法)
  • [2.2 重点方法](#2.2 重点方法)
• 三、ComponentName的使用

---

一、ComponentName是什么？

ComponentName，顾名思义，就是组件名称，用于表示Android应用程序组件的名称。在Android开发中，每个应用程序组件（如Activity、Service、BroadcastReceiver等）都有一个唯一的组件名称，用于标识该组件在Android系统中的位置。

ComponentName类的主要作用是用于创建和管理Android应用程序组件的名称。

通过ComponentName对象，可以获取组件的包名和类名，还可以比较两个ComponentName对象的大小关系。

同时，ComponentName类还实现了Parcelable接口，可以在不同组件之间传递ComponentName对象。

在Android开发中，ComponentName类通常用于与Android系统进行交互，如启动其他应用程序的组件、获取应用程序组件的信息等。

通过ComponentName类，开发者可以方便地操作和管理Android应用程序组件的名称，实现更灵活的应用程序设计。

---

二、类分析

public final class ComponentName implements Parcelable, Cloneable, Comparable<ComponentName> {

由于实现了Parcelable、Cloneable和Comparable< ComponentName>接口，ComponentName类具有了序列化、克隆和比较功能。

2.1 构造方法

   public ComponentName(@NonNull String pkg, @NonNull String cls) {
        if (pkg == null) throw new NullPointerException("package name is null");
        if (cls == null) throw new NullPointerException("class name is null");
        mPackage = pkg;
        mClass = cls;
    }

    public ComponentName(@NonNull Context pkg, @NonNull String cls) {
        if (cls == null) throw new NullPointerException("class name is null");
        mPackage = pkg.getPackageName();
        mClass = cls;
    }

    public ComponentName(@NonNull Context pkg, @NonNull Class<?> cls) {
        mPackage = pkg.getPackageName();
        mClass = cls.getName();
    }

public ComponentName(@NonNull String pkg, @NonNull String cls)

通过给定的包名和类名创建一个新的ComponentName对象。

如果包名或类名为null，则会抛出NullPointerException异常。

参数：

pkg：包名

cls：类名
public ComponentName(@NonNull Context pkg, @NonNull String cls)

通过给定的Context对象和类名创建一个新的ComponentName对象。

从Context对象中获取实际的包名。

如果类名为null，则会抛出NullPointerException异常。

参数：

pkg：实现组件的包的Context对象

cls：类名
public ComponentName(@NonNull Context pkg, @NonNull Class<?> cls)

通过给定的Context对象和Class对象创建一个新的ComponentName对象。

从Context对象中获取实际的包名，从Class对象中获取实际的类名。

参数：

pkg：实现组件的包的Context对象

cls：所需组件的Class对象

三个构造方法提供了不同的方式来创建ComponentName对象，开发者可以根据需要选择合适的构造方法来实例化ComponentName对象。通过这些构造方法，可以方便地创建表示Android应用程序组件的名称的ComponentName对象，并在应用程序中进行相关操作。

2.2 重点方法

	 // 获取包名
    public @NonNull String getPackageName() {
        return mPackage;
    }

    // 获取类名
    public @NonNull String getClassName() {
        return mClass;
    }
    //该方法用于获取组件的短类名，即去除包名后的类名部分。
    public String getShortClassName() {
    if (mClass.startsWith(mPackage)) {
        int PN = mPackage.length();
        int CN = mClass.length();
        if (CN > PN && mClass.charAt(PN) == '.') {
            return mClass.substring(PN, CN);
        }
    }
    return mClass;
    }
    
    //通过createRelative()方法，可以根据给定的包名和类名创建一个相对的ComponentName对象。
	   public static @NonNull ComponentName createRelative(@NonNull String pkg, @NonNull String cls) {
	    if (TextUtils.isEmpty(cls)) {
	        throw new IllegalArgumentException("class name cannot be empty");
	    }
	
	    final String fullName;
	    if (cls.charAt(0) == '.') {
	        // Relative to the package. Prepend the package name.
	        fullName = pkg + cls;
	    } else {
	        // Fully qualified package name.
	        fullName = cls;
	    }
	    return new ComponentName(pkg, fullName);
	 }

---

三、ComponentName的使用

ComponentName实例化组件

第一个参数是要启动应用的包名称，这个包名称是指清单文件中列出的应用的包名称：

第二个参数是你要启动的Activity或者Service的全称（包名+类名），代码如下：

启动一个Activity：

   Intent intent = new Intent();
   intent.setComponent(new ComponentName("com.android.henrytest", "com.android.henrytest.MainActivity"));
   startActivity(intent);

启动一个Service：

	Intent it = new Intent();
	it.setComponent(new ComponentName("com.example.otherapp",
			"com.example.otherapp.MyService"));
	startService(it);

注意:

如果要启动的其他应用的Activity不是该应用的入口Activity，那么在清单文件中，该Activity节点一定要加上android:exported="true"，表示允许其他应用打开，对于所有的Service，如果想从其他应用打开，也都要加上这个属性：

        <service
            android:name="com.example.otherapp.MyService"
            android:exported="true" >
        </service>
 
        <activity
            android:name="com.example.otherapp.MainActivity2"
            android:exported="true" >
        </activity>

对于除了入口Activity之外的其他组件，如果不加这个属性，会抛出"java.lang.SecurityException: Permission Denial."异常

入口Activity不需要加此属性的原因是：

包含了过滤器的组件，意味着该组件可以提供给外部的其他应用来使用，它的exported属性默认为true，相反，如果一个组件不包含任何过滤器，那么意味着该组件只能通过指定明确的类名来调用，也就是说该组件只能在应用程序的内部使用，在这种情况下，exported属性的默认值是false。

        <activity
            android:name="com.android.henrytest.iccpanelActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            <meta-data
                android:name="meta_act"
                android:resource="@string/app_name" />
        </activity>