在Android开发调试时,有以下两种情况:
- 多人开发时,每个人分别处理不同的Activity,此时若不同Activity间暂时没有实现跳转功能,则处理非MainActivity(假设为应用默认启动的Activity)的开发人员将无法直接启动和跳转到当前处理的Activity,此时若直接修改Manifest文件,则会出现不同开发人员的Manifest文件不同的情况,在同步代码时如果同步了Manifest,每次都会发生冲突。
- 任意情况下,Activity的层次较深,即从起始Activity要经过多层交互才能到达。
上述两种情况下,都有不同的解决方案,而笔者期望能够在不改变代码的情况下初始启动任意Activity,为此笔者做了一番研究。
首先,通过adb shell可以使用命令行启动不同action和category的Activity,通常情况下,可以通过以下命令启动MainActivity(假设为应用默认启动的Activity):
adb shell am start -n com.vilyever/com.vilyever.MainActivity
然而如果将MainActivity替换成其他Activity,则会报错(java.lang.SecurityException: Permission Denial: starting Intent from null (pid=2413, uid=2000)无法启动。
这是由于通常Acitivity是不能随意被外部启动的,若在Manifest文件中为Activity添加android:exported=”true”属性,则在Terminal运行
adb shell am start -n com.vilyever/com.vilyever.TestActivity
即可以启动任意Activity
那么有没有其他方法呢?
通过官方文档ADB Shell Commands没有提供adb shell am start 的具体参数,所以笔者直接在Terminal运行adb shell am start,结果如下:
[-a <ACTION>] [-d <DATA_URI>] [-t <MIME_TYPE>]
[-c <CATEGORY> [-c <CATEGORY>] …]
[-e|–es <EXTRA_KEY> <EXTRA_STRING_VALUE> …]
[–esn <EXTRA_KEY> …]
[–ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE> …]
[–ei <EXTRA_KEY> <EXTRA_INT_VALUE> …]
[–el <EXTRA_KEY> <EXTRA_LONG_VALUE> …]
[–ef <EXTRA_KEY> <EXTRA_FLOAT_VALUE> …]
[–eu <EXTRA_KEY> <EXTRA_URI_VALUE> …]
[–ecn <EXTRA_KEY> <EXTRA_COMPONENT_NAME_VALUE>]
[–eia <EXTRA_KEY> <EXTRA_INT_VALUE>[,<EXTRA_INT_VALUE…]]
[–ela <EXTRA_KEY> <EXTRA_LONG_VALUE>[,<EXTRA_LONG_VALUE…]]
[–efa <EXTRA_KEY> <EXTRA_FLOAT_VALUE>[,<EXTRA_FLOAT_VALUE…]]
[-n <COMPONENT>] [-f <FLAGS>]
[–grant-read-uri-permission] [–grant-write-uri-permission]
[–debug-log-resolution] [–exclude-stopped-packages]
[–include-stopped-packages]
[–activity-brought-to-front] [–activity-clear-top]
[–activity-clear-when-task-reset] [–activity-exclude-from-recents]
[–activity-launched-from-history] [–activity-multiple-task]
[–activity-no-animation] [–activity-no-history]
[–activity-no-user-action] [–activity-previous-is-top]
[–activity-reorder-to-front] [–activity-reset-task-if-needed]
[–activity-single-top] [–activity-clear-task]
[–activity-task-on-home]
[–receiver-registered-only] [–receiver-replace-pending]
[–selector]
[<URI> | <PACKAGE> | <COMPONENT>]
可以看到-a参数代表了Activity的action,-d参数代表Activity的data。
笔者曾经做过浏览器输入地址跳转应用,发现可以利用这一点直接打开拥有某个特定<intent-filter>的Activity。
之后笔者进行一个测试:
在TestActivity的Manifest声明中添加
<activity
android:name="com.vilyever.TestActivity"
android:theme="@style/AppTheme.NoActionBar"
>
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="vilyever" />
<data android:host="testactivity" />
</intent-filter>
</activity>
可以看到,这个Activity可以通过scheme进行跳转。
所以在运行应用后,笔者在Terminal中输入:
adb shell am start -a android.intent.action.VIEW -d vilyever://testactivity
这样就可以打开指定的Activity
以上两种方法都可以通过Terminal输入命令打开任意Activity,然而这需要两步操作
- 运行app
- 输入adb命令
有可能简化成一步完成吗?
笔者通过查询发现gradle可以实现安装app和运行adb命令,那么将他们集合成一个task就可以实现一键启动任意Activity。
在app模块的build.gradle文件下添加task
apply plugin: 'com.android.application' // 必须是application的plugin才能安装应用
android {
...
}
dependencies {
...
}
// 启动android:exported="true"的Activity
task startExportedTestActivity(type: Exec, dependsOn: 'installDebug') {
commandLine 'cmd', '/c', 'adb', 'shell', 'am', 'start', '-n', 'com.vilyever/com.vilyever.TestActivity'
}
// 启动添加了scheme的Activity
task startSchemeTestActivity(type: Exec, dependsOn: 'installDebug') {
commandLine 'cmd', '/c', 'adb', 'shell', 'am', 'start', '-a', 'android.intent.action.VIEW', '-d', 'vilyever://testactivity'
}
两种task都可以启动Activity,可以看到只要修改最后的参数就可以启动不同的Activity
运行task的方法:展开AS右边Gradle,点击(Excute Gradle Task)圆圈按钮,选择当前project,输入task名,点击OK运行
然而
方法一:需要在Manifest中Activity下添加android:exported=”true”
方法二:需要在Manifest中Activity下添加scheme
先前说过,这些属性是在开发调试时暂时添加的,那么可能出现以下问题:
- 如果某些Activity原来就需要这些属性,那么在正式发布应用时可能被误删
- 如果在发布应用时忘记删除这些属性,则这些Activity将全部暴露一个可以从外部启动的接口,有可能被其他恶意应用用作钓鱼欺骗等行为
如何解决呢
因为实现任意跳转是为了方便调试,那么通常是在生成debug版本app时用到的,如果能够在debug时自动修改Manifest文件使其支持启动任意Activity,在发布release版本时又不进行修改,那么我们仅需为每个Activity添加启动task就能顺利实现这个需求了。
通过gradle可以实现这个功能,在app模块的build.gradle文件下的android{}最后添加
apply plugin: 'com.android.application' // 必须是application的plugin才能安装应用
android {
...
applicationVariants.all { variant ->
variant.outputs.each { output ->
if ("${variant.dirName}".contains("debug")) {
output.processManifest.doLast {
def manifestOutFile = output.processManifest.manifestOutputFile
def activities = manifestOutFile.getText('UTF-8').split("<activity")
def newFileContents = ""
for (def activity : activities) {
if (!activity.contains("<manifest")) {
if (activity.contains("exported")) {
activity = activity.replace("android:exported=\"false\"", "android:exported=\"true\"")
}
else {
activity = "\n android:exported=\"true\"" + activity
}
}
newFileContents = newFileContents + activity
if (!activity.contains("</manifest>")) {
newFileContents = newFileContents + "<activity"
}
}
manifestOutFile.write(newFileContents, 'UTF-8')
}
}
}
}
}
dependencies {
...
}
// 启动android:exported="true"的Activity
task startExportedTestActivity(type: Exec, dependsOn: 'installDebug') {
commandLine 'cmd', '/c', 'adb', 'shell', 'am', 'start', '-n', 'com.vilyever/com.vilyever.TestActivity'
}
上述applicationVariants.all {}实现的功能是:
在debug时,若Manifest中Activity声明了android:exported属性,将其改为true;若未声明android:exported,则为其加上android:exported=”true”
这样,再通过adb shell am start -n (包名)/(包名).(Activity名)就可以直接启动Activity
结合gradle的task就可以一键启动想要调试的Activity。
以上就是此次研究的成果,感谢阅读。