程序

from ascript.android import system

方法

关闭

关闭当前程序

• 函数

system.exit()

• 示例

#退出小程序 3秒后
from ascript.android import system
import time

time.sleep(3)
system.exit()

---

重启

重启当前程序

• 函数

system.reboot(delay_time:int=0)

参数	类型	是否必填	说明
delay_time	int	否	延迟重启的时间,单位毫秒 默认:0,立即重启

• 示例

#重启小程序 立刻
from ascript.android import system
import time

print("我启动了")

system.reboot()

#重启小程序 3秒后
from ascript.android import system
import time

print("我启动了")

system.reboot(3000)

---

启动应用

打开已安装的应用

部分手机无法启动应用 解决方案!

如“华为手机”在系统设置中有 启动关联开关选项,此开关需要手动操作 允许关联应用启动.

开启后,使用system.open() 可启动任意应用

• 函数

system.open(name_or_package:str)

参数	类型	是否必填	说明
name_or_package	str	是	启动的应用名称或包名 注意:"包名启动快于应用名称启动" 包名称可以通过[APP-开发者-查包工具]获得

• 示例

from ascript.android import system

# 根据应用名称启动. PS:启动略慢于包名启动
system.open("微信")

from ascript.android import system

# 根据包名启动,推荐使用
system.open("com.autonavi.minimap")

关闭应用

尝试关闭正在运行的APP

无障碍模式

无障碍模式并无权限直接关闭!

我们只能靠意图前往应用详情页面,再次点击停止按钮进行关闭.

• 跳转应用详情的代码

from airscript.intent import Intent 
from ascript.android.system import R
from android.net import Uri
from android.provider import Settings

# 根据需求改变包名,即可跳转,跳转后,可点击停止程序等等.
pakage_name = "com.aojoy.airscript" # 改为目标app包名
intent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).setData(Uri.fromParts("package", pakage_name, None))
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
R.context.startActivity(intent)

Root模式

如果你的设备拥有root权限,可以直接使用 shell指令去执行操作.

# root模式下,可根据包名直接关闭app
from ascript.android import system
pakage_name = "com.aojoy.airscript" # 请更换为你的app
system.shell("am force-stop "+pakage_name)

Shizuku激活模式

如果你的手机没有root,可以尝试用shizuku激活root

# 激活模式下,可根据包名直接关闭app
from ascript.android import shizuku
pakage_name = "com.aojoy.airscript" # 请更换为你的app
shizuku.shell("am force-stop "+pakage_name)

打开网页

用浏览器打开网页

• 函数

system.browser(url:str)

参数	类型	是否必填	说明
url	str	是	启动的网址 如:(http://www.airscript.com)

• 示例

# 案例:打开AirSctipt 官网
#导包
from ascript.android import system

# 输入网址,用浏览器打开
system.browser("http://www.airscript.cn")

---

获取当前运行APP

获取当前正在运行的APP,默认获取1分钟内打开的操作.

• 函数

system.get_foreground_app()

• 返回

app包名: str

• 示例

# 案例:获取当前运行的app包名
#导包
from ascript.android import system

app_package = system.get_foreground_app()
print(app_package)

---

Root指令

重启当前程序

Root设备

只有Root 设备可用

• 函数

system.shell(adb_root:str)

参数	类型	是否必填	说明
adb_root	str	否	可执行的 shell指令

• 返回值

Result

包含两个属性: res:shell指令的回执消息. error:如果命令行指令出错,返回的错误信息

from ascript.android import system

r = system.shell("pm list packages")

# 打印 命令行回执消息
if r.res:
    for x in r.res:
        print(x)

# 打印 命令行错误回执消息
if r.error:
    print("命令行指令出错了")
    for x in r.error:
        print(x)

---

运行时内存信息

获取系统内存信息,获取低内存状态等.

from ascript.android import system
memory_info = system.memory()
# 可用内存
print(memory_info.availMem)
# 系统总内存
print(memory_info.totalMem)
# 系统是否处于低内存状态
print(memory_info.lowMemory)

获取外部存储信息

外部存储,包含所有sd拓展卡的存储空间信息(R.sd()获取的地址即为外部存储)

from ascript.android import system
sd_info = system.get_external_storage_info()
# 可用内存
print(sd_info.availableSpaceBytes)
# 系统总内存
print(sd_info.totalSpaceBytes)
# 获取格式化后的 可用内存
print(sd_info.getFormattedAvailableSpace())
# 获取格式化后的 系统总内存
print(sd_info.getFormattedTotalSpace())

获取内部存储信息

内部内存,手机内存. 一般没有Root不可访问.

from ascript.android import system
in_info = system.get_internal_storage_info()
# 可用内存
print(in_info.availableSpaceBytes)
# 系统总内存
print(in_info.totalSpaceBytes)
# 获取格式化后的 可用内存
print(in_info.getFormattedAvailableSpace())
# 获取格式化后的 系统总内存
print(in_info.getFormattedTotalSpace())

获取导航栏模式

该方法并不精准

非官方内置安全的方法,各厂商适配不同.

可以获取经典3按键导航栏,或者全面屏收拾导航等模式.

from ascript.android import system
mode =  system.get_navigation_mode()
if mode ==0 :
    print("经典3按键导航模式")
else:
    print("全面屏幕模式")

---

获取应用名称

根据包名获取应用的显示名称

• 函数

system.get_app_name(package_name:str)

参数	类型	必须	备注
package_name	str	是	应用包名

• 返回值

str类型, 应用名称. 如果包名不存在返回 None

• 示例

from ascript.android import system
name = system.get_app_name("com.tencent.mm")
print(name)  # 微信

---

打开应用设置页

打开指定应用的系统设置页面(可用于清除数据、查看权限等)

• 函数

system.open_app_setting(package_name:str)

参数	类型	必须	备注
package_name	str	是	应用包名

• 示例

# 打开微信的应用设置页
from ascript.android import system
system.open_app_setting("com.tencent.mm")

---

等待应用出现

等待指定应用出现在前台,可设置超时时间

• 函数

system.wait_for_package(package_name:str, timeout:int=30000)

参数	类型	必须	备注
package_name	str	是	应用包名
timeout	int	否	超时时间,单位毫秒,默认30000(30秒)

• 返回值

bool类型, True:应用已出现在前台, False:超时未出现

• 示例

from ascript.android import system

# 启动微信
system.open("com.tencent.mm")

# 等待微信出现在前台,最多等10秒
if system.wait_for_package("com.tencent.mm", 10000):
    print("微信已打开")
else:
    print("微信打开超时")