DynamicIconame

动态更换桌面APP图标和名称

activity-alias

Android里为了重复使用Activity而设计的。

1. 含义和作用:

     对于activity-alias标签，它有一个属性叫android:targentActivity，这个属性就是用来为该标签设置目标Activity的，或者说它就是这个目标Activity的别名。
     activity-alias作为一个已存在Activity的别名，则应该可以通过该别名标签声明快速打开目标Activity。
     因此activity-alias可用来设置某个Activity的快捷入口，可以放在桌面上或者通过该别名被其他组件快速调起。
   

2. 部分属性说明如下

   1. android:enable 该属性用来决定目标Activity可否通过别名被系统实例化，默认为true。 需要注意的是application也有enable属性，只用当它们同时为true时，activity-alias的enable才生效。

   2. android:exported 该属性为true的话，则目标Activity可被其他应用调起，如为false则只能被应用自身调起。 其默认值根据activity-alias是否包含intent-filter元素决定，如果有的话，则默认为true；没有的话则为false。 其实也很好理解，如果有intent-filter，则目标Activity可以匹配隐式Intent，因此可被外部应用唤起； 如果没有intent-filter，则目标Activity要被调起的话必须知道其精确类名，因为只有应用本身才知道精确类名，所以此时默认为false。

   3. android:icon 该属性就比较好玩了，允许自定义icon，可以不同于应用本身在桌面的icon。如果需要在桌面上创建快捷入口，也许产品会要求换个不同的icon。

   4. android:label 该属性类似于android:icon，图标都换了，换个名称也合情合理吧，此属性就是为此而生的。

   5. android:name 该属性可以为任意字符串，但最好符合类名命名规范。activity元素的name属性实质上都会指向一个具体的Activity类，而activity-alias的name属性仅作为一个唯一标识而已。

   6. android:permission 该属性指明了通过别名声明调起目标Activity所必需的权限。

   7. android:targetActivity 该属性指定了目标Activity，即通过activity-alias调起的Activity是哪个，此属性其实类似于activity标签中的name属性，需要规范的Activity包名类名。

3. 注意: 在AndroidManifest配置文件中，activity-alias标签元素必须声明在目标Acitvity对应的activity标签元素之后，否则会编译错误。

4. 使用案例: 当在Activity的onCreate()方法里，执行getIntent().getComponent().getClassName(); 得到的可能不是这个Activity的名字，有可能是别名的名字，例如：在AndroidMenifest.xml有如下配置：

    <application
    android:allowBackup="true"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/AppTheme">
    <activity android:name=".MainActivity">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
   
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
   
    <activity-alias
        android:name="com.dynamic.iconame.AliasActivity"
        android:enabled="false"
        android:icon="@mipmap/icon_alias"
        android:configChanges="keyboardHidden|orientation|screenSize|smallestScreenSize|screenLayout"
        android:launchMode="singleTop"
        android:screenOrientation="portrait"
        android:theme="@style/AppTheme"
        android:windowSoftInputMode="stateAlwaysHidden|adjustPan"
        android:label="别名"
        android:targetActivity=".MainActivity">
        <meta-data
            android:name="android.notch_support"
            android:value="true" />
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
            <category android:name="android.intent.category.MULTIWINDOW_LAUNCHER" />
            <category android:name="miui.intent.category.SYSAPP_RECOMMEND" />
        </intent-filter>
    </activity-alias>
   
    <activity-alias
        android:name="com.dynamic.iconame.Alias2Activity"
        android:enabled="false"
        android:icon="@mipmap/icon_alias2"
        android:configChanges="keyboardHidden|orientation|screenSize|smallestScreenSize|screenLayout"
        android:launchMode="singleTop"
        android:screenOrientation="portrait"
        android:theme="@style/AppTheme"
        android:label="别名2"
        android:windowSoftInputMode="stateAlwaysHidden|adjustPan"
        android:targetActivity=".MainActivity">
        <meta-data
            android:name="android.notch_support"
            android:value="true" />
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
            <category android:name="android.intent.category.MULTIWINDOW_LAUNCHER" />
            <category android:name="miui.intent.category.SYSAPP_RECOMMEND" />
        </intent-filter>
    </activity-alias>
   

总结： 1.更换桌面图标不是马上生效，需要一段时间才生效（10S内） 2.当app不是默认图标时，再run 'app'，就会报错 'Session "app":Error Launching activity' Error while executing: am start -n "com.dynamic.iconame/com.dynamic.iconame.MainActivity" -a android.intent.action.MAIN -c android.intent.category.LAUNCHER Starting: Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=com.dynamic.iconame/.MainActivity } Error type 3 Error: Activity class {com.dynamic.iconame/com.dynamic.iconame.MainActivity} does not exist. Error while Launching activity 需要卸载当前APP，然后重新编译运行即可。