添加了API函数以及文档
This commit is contained in:
gfdgd xi
parent
c9a3db2f37
commit
d68f42c368
|
|
@ -0,0 +1,2 @@
|
||||||
|
import api
|
||||||
|
xxx = api.APK()
|
||||||
|
|
@ -0,0 +1,67 @@
|
||||||
|
# API 介绍
|
||||||
|
# 必知
|
||||||
|
1. 此 API 只支持可以运行 UEngine 的 Linux 上，Windows 上无法使用
|
||||||
|
2. 部分函数需要 root 权限
|
||||||
|
3. 这是 UEngine 运行器的函数重构，所以一些 UEngine 运行器上没有的 bug 可能在这个 API 里有
|
||||||
|
## ProgramInformation
|
||||||
|
用于获取一些程序信息，详细如下（此为变量）：
|
||||||
|
| 变量名 | 变量介绍 |
|
||||||
|
|:-:|:-:|
|
||||||
|
| programPath | 获取程序所在路径 |
|
||||||
|
| version | API 版本 |
|
||||||
|
| updateTime | 更新时间 |
|
||||||
|
| websize | 程序官网 |
|
||||||
|
|
||||||
|
## Check
|
||||||
|
用于检查 API 所需的东西是否完整，详细如下：
|
||||||
|
| 函数名 | 函数介绍 |
|
||||||
|
|:-:|:-:|
|
||||||
|
| CheckDepend() | 检查 API 所需的依赖是否完整 |
|
||||||
|
|
||||||
|
## ROOT
|
||||||
|
用于检查 ROOT 方面问题，详细如下：
|
||||||
|
| 函数名 | 函数介绍 |
|
||||||
|
|:-:|:-:|
|
||||||
|
| GetRoot() | 检查程序/API是否以 ROOT 权限运行 |
|
||||||
|
|
||||||
|
## APK
|
||||||
|
这是面向对象的写法，所以应用方式也不一样：
|
||||||
|
```python
|
||||||
|
import api
|
||||||
|
xxx = api.APK("APK 所在路径")
|
||||||
|
```
|
||||||
|
具体函数介绍：
|
||||||
|
| 函数名 | 函数介绍 |
|
||||||
|
|:-:|:-:|
|
||||||
|
| xxx.install() | 安装这个 APK 包 |
|
||||||
|
| xxx.uninstall()| 卸载这个 APK 包 |
|
||||||
|
| xxx.information()| 获取从 aapt 获取到的 APK 信息 |
|
||||||
|
| xxx.activityName() | 获取 APK 的 Activity 信息 |
|
||||||
|
| xxx.packageName() | 获取 APK 包名 |
|
||||||
|
| xxx.chineseLabel() | 获取 APK 中文名称 |
|
||||||
|
| xxx.saveApkIcon("图标保存路径") | 保存 APK 的图标到指定路径 |
|
||||||
|
| xxx.version() | 获取 APK 版本号 |
|
||||||
|
|
||||||
|
## UEngine
|
||||||
|
用于对 UEngine 进行一点点操控，详细如下：
|
||||||
|
| 函数名 | 函数介绍 |
|
||||||
|
|:-:|:-:|
|
||||||
|
| CPUCheck() | 检查 CPU 是否支持运行 UEngine |
|
||||||
|
| Services | 用于操控 UEngine 服务的类，见下 |
|
||||||
|
| InternetBridge | 用于操控 UEngine 网络桥接的类，见下 |
|
||||||
|
### Services
|
||||||
|
关于 UEngine 的服务控制：
|
||||||
|
| 函数名 | 函数介绍 |
|
||||||
|
|:-:|:-:|
|
||||||
|
| Services.Open() | 打开 UEngine 服务 |
|
||||||
|
| Services.Close() | 关闭 UEngine 服务 |
|
||||||
|
| Services.Restart() | 重启 UEngine 服务 |
|
||||||
|
### InternetBridge
|
||||||
|
关于 UEngine 的网络桥接控制：
|
||||||
|
| 函数名 | 函数介绍 |
|
||||||
|
|:-:|:-:|
|
||||||
|
| InternetBridge.Open() | 打开 UEngine 网络桥接 |
|
||||||
|
| InternetBridge.Close() | 关闭 UEngine 网络桥接 |
|
||||||
|
| InternetBridge.Restart() | 重启 UEngine 网络桥接 |
|
||||||
|
| InternetBridge.Reload() | 重新加载 UEngine 网络桥接 |
|
||||||
|
| InternetBridge.ForceReload() | 强制加载 UEngine 网络桥接 |
|
||||||
|
|
@ -0,0 +1,143 @@
|
||||||
|
import os
|
||||||
|
import shutil
|
||||||
|
import zipfile
|
||||||
|
import traceback
|
||||||
|
import subprocess
|
||||||
|
from getxmlimg import getsavexml
|
||||||
|
|
||||||
|
class ProgramInformation:
|
||||||
|
programPath = os.path.split(os.path.realpath(__file__))[0] # 返回 string
|
||||||
|
version = "1.6.0Alpha1"
|
||||||
|
updateTime = "2022年05月15日"
|
||||||
|
websize = ["https://gitee.com/gfdgd-xi/uengine-runner", "https://github.com/gfdgd-xi/uengine-runner"]
|
||||||
|
|
||||||
|
# 判断程序以正确方式运行
|
||||||
|
class Check:
|
||||||
|
def CheckDepend():
|
||||||
|
depend = ["/usr/bin/uengine", "UEngine", "/usr/bin/adb", "adb", "/usr/bin/uengine-session-launch-helper", "UEngine", "/usr/bin/aapt", "aapt"]
|
||||||
|
for i in range(0, len(depend), 2):
|
||||||
|
if not os.path.exists(depend[i]):
|
||||||
|
print("依赖{}不存在".format(depend[i + 1]))
|
||||||
|
|
||||||
|
class ROOT:
|
||||||
|
def GetRoot():
|
||||||
|
return os.geteuid() == 0
|
||||||
|
|
||||||
|
class APK:
|
||||||
|
def __init__(self, apkPath):
|
||||||
|
self.apkPath = apkPath
|
||||||
|
|
||||||
|
def install(self):
|
||||||
|
os.system("pkexec /usr/bin/uengine-session-launch-helper -- uengine install --apk='{}'".format(self.apkPath))
|
||||||
|
|
||||||
|
def uninstall(self):
|
||||||
|
os.system("pkexec /usr/bin/uengine-session-launch-helper -- uengine uninstall --pkg='{}'".format(self.apkPath))
|
||||||
|
|
||||||
|
def information(self):
|
||||||
|
return subprocess.getoutput("aapt dump badging '{}'".format(self.apkPath))
|
||||||
|
|
||||||
|
def activityName(self):
|
||||||
|
info = self.information()
|
||||||
|
for line in info.split('\n'):
|
||||||
|
if "launchable-activity" in line:
|
||||||
|
line = line[0: line.index("label='")]
|
||||||
|
line = line.replace("launchable-activity: ", "")
|
||||||
|
line = line.replace("'", "")
|
||||||
|
line = line.replace(" ", "")
|
||||||
|
line = line.replace("name=", "")
|
||||||
|
line = line.replace("label=", "")
|
||||||
|
line = line.replace("icon=", "")
|
||||||
|
return line
|
||||||
|
|
||||||
|
# 获取 apk 包名
|
||||||
|
def packageName(self):
|
||||||
|
info = self.information()
|
||||||
|
for line in info.split('\n'):
|
||||||
|
if "package:" in line:
|
||||||
|
line = line[0: line.index("versionCode='")]
|
||||||
|
line = line.replace("package:", "")
|
||||||
|
line = line.replace("name=", "")
|
||||||
|
line = line.replace("'", "")
|
||||||
|
line = line.replace(" ", "")
|
||||||
|
return line
|
||||||
|
|
||||||
|
# 获取软件的中文名称
|
||||||
|
def chineseLabel(self) -> "获取软件的中文名称":
|
||||||
|
info = self.information()
|
||||||
|
for line in info.split('\n'):
|
||||||
|
if "application-label:" in line:
|
||||||
|
line = line.replace("application-label:", "")
|
||||||
|
line = line.replace("'", "")
|
||||||
|
return line
|
||||||
|
|
||||||
|
# 保存apk图标
|
||||||
|
def saveApkIcon(self, iconSavePath) -> "保存 apk 文件的图标":
|
||||||
|
try:
|
||||||
|
if os.path.exists(iconSavePath):
|
||||||
|
os.remove(iconSavePath)
|
||||||
|
info = self.information()
|
||||||
|
for line in info.split('\n'):
|
||||||
|
if "application:" in line:
|
||||||
|
xmlpath = line.split(":")[-1].split()[-1].split("=")[-1].replace("'", "")
|
||||||
|
if xmlpath.endswith('.xml'):
|
||||||
|
xmlsave = getsavexml()
|
||||||
|
print(xmlpath)
|
||||||
|
xmlsave.savexml(self.apkPath, xmlpath, iconSavePath)
|
||||||
|
return
|
||||||
|
else:
|
||||||
|
zip = zipfile.ZipFile(self.apkPath)
|
||||||
|
iconData = zip.read(xmlpath)
|
||||||
|
with open(iconSavePath, 'w+b') as saveIconFile:
|
||||||
|
saveIconFile.write(iconData)
|
||||||
|
return
|
||||||
|
print("None Icon! Show defult icon")
|
||||||
|
shutil.copy(ProgramInformation.programPath + "/defult.png", iconSavePath)
|
||||||
|
except:
|
||||||
|
traceback.print_exc()
|
||||||
|
print("Error, show defult icon")
|
||||||
|
shutil.copy(ProgramInformation.programPath + "/defult.png", iconSavePath)
|
||||||
|
|
||||||
|
def version(self):
|
||||||
|
info = self.information()
|
||||||
|
for line in info.split('\n'):
|
||||||
|
if "package:" in line:
|
||||||
|
if "compileSdkVersion='" in line:
|
||||||
|
line = line.replace(line[line.index("compileSdkVersion='"): -1], "")
|
||||||
|
if "platform" in line:
|
||||||
|
line = line.replace(line[line.index("platform"): -1], "")
|
||||||
|
line = line.replace(line[0: line.index("versionName='")], "")
|
||||||
|
line = line.replace("versionName='", "")
|
||||||
|
line = line.replace("'", "")
|
||||||
|
line = line.replace(" ", "")
|
||||||
|
return line
|
||||||
|
class UEngine:
|
||||||
|
def CPUCheck():
|
||||||
|
return subprocess.getoutput("uengine check-features")
|
||||||
|
class Services:
|
||||||
|
def Open():
|
||||||
|
os.system("pkexec systemctl enable uengine-container uengine-session && systemctl start uengine-container uengine-session")
|
||||||
|
def Close():
|
||||||
|
os.system("pkexec systemctl disable uengine-container uengine-session")
|
||||||
|
def Restart():
|
||||||
|
os.system("pkexec systemctl restart uengine*")
|
||||||
|
|
||||||
|
class InternetBridge:
|
||||||
|
def Open():
|
||||||
|
os.system("pkexec uengine-bridge.sh start")
|
||||||
|
def Close():
|
||||||
|
os.system("pkexec uengine-bridge.sh stop")
|
||||||
|
def Restart():
|
||||||
|
os.system("pkexec uengine-bridge.sh restart")
|
||||||
|
def Reload():
|
||||||
|
os.system("pkexec uengine-bridge.sh reload")
|
||||||
|
def ForceReload():
|
||||||
|
os.system("pkexec uengine-bridge.sh force-reload")
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
print("本 API 不支持直接运行，请通过引入的方式使用此 API")
|
||||||
|
apki = APK("/home/gfdgd_xi/下载/com.mihoyo.cloudgames.ys_1.0.0_liqucn.com.apk")
|
||||||
|
print(apki.packageName())
|
||||||
|
quit()
|
||||||
|
|
||||||
|
if not ROOT.GetRoot():
|
||||||
|
print("请获取 ROOT 权限以便更好的使用该 API")
|
||||||
Binary file not shown.
|
|
@ -1,23 +0,0 @@
|
||||||
import os
|
|
||||||
import subprocess
|
|
||||||
import getxmlimg
|
|
||||||
# 判断程序以正确方式运行
|
|
||||||
class ROOT:
|
|
||||||
def GetRoot():
|
|
||||||
return os.geteuid() == 0
|
|
||||||
|
|
||||||
class APK:
|
|
||||||
def __init__(self, apkPath):
|
|
||||||
self.apkPath = apkPath
|
|
||||||
|
|
||||||
def install(self):
|
|
||||||
os.system("pkexec /usr/bin/uengine-session-launch-helper -- uengine install --apk='{}'".format(self.apkPath))
|
|
||||||
|
|
||||||
def information(self):
|
|
||||||
return subprocess.getoutput("aapt dump badging '{}'".format(self.apkPath))
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
|
||||||
print("本 API 不支持直接运行，请通过引入的方式使用此 API")
|
|
||||||
quit()
|
|
||||||
if not ROOT.GetRoot():
|
|
||||||
print("请获取 ROOT 权限以便更好的使用该 API")
|
|
||||||
Loading…
Reference in New Issue