From d68f42c3685fdbf9db561672e7baa5ecf7220ff2 Mon Sep 17 00:00:00 2001
From: gfdgd xi <3025613752@qq.com>
Date: Sun, 15 May 2022 21:54:04 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E4=BA=86API=E5=87=BD?=
=?UTF-8?q?=E6=95=B0=E4=BB=A5=E5=8F=8A=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
api-test.py | 2 +
api/README.md | 67 +++++++++++
api/__init__.py | 143 +++++++++++++++++++++++
api/__pycache__/getxmlimg.cpython-37.pyc | Bin 0 -> 3202 bytes
{uengine-runner-api => api}/getxmlimg.py | 0
uengine-runner-api/__init__.py | 23 ----
6 files changed, 212 insertions(+), 23 deletions(-)
create mode 100644 api-test.py
create mode 100644 api/README.md
create mode 100644 api/__init__.py
create mode 100644 api/__pycache__/getxmlimg.cpython-37.pyc
rename {uengine-runner-api => api}/getxmlimg.py (100%)
delete mode 100644 uengine-runner-api/__init__.py
diff --git a/api-test.py b/api-test.py
new file mode 100644
index 0000000..79870ba
--- /dev/null
+++ b/api-test.py
@@ -0,0 +1,2 @@
+import api
+xxx = api.APK()
\ No newline at end of file
diff --git a/api/README.md b/api/README.md
new file mode 100644
index 0000000..0a331da
--- /dev/null
+++ b/api/README.md
@@ -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 网络桥接 |
\ No newline at end of file
diff --git a/api/__init__.py b/api/__init__.py
new file mode 100644
index 0000000..8809d83
--- /dev/null
+++ b/api/__init__.py
@@ -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")
\ No newline at end of file
diff --git a/api/__pycache__/getxmlimg.cpython-37.pyc b/api/__pycache__/getxmlimg.cpython-37.pyc
new file mode 100644
index 0000000000000000000000000000000000000000..79021ab50d040d3e4ab5ae5fd955c94806704893
GIT binary patch
literal 3202
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
QH10AQ$`$>kgZDJQ2mHJ!MF0Q*
literal 0
HcmV?d00001
diff --git a/uengine-runner-api/getxmlimg.py b/api/getxmlimg.py
similarity index 100%
rename from uengine-runner-api/getxmlimg.py
rename to api/getxmlimg.py
diff --git a/uengine-runner-api/__init__.py b/uengine-runner-api/__init__.py
deleted file mode 100644
index 226a2c7..0000000
--- a/uengine-runner-api/__init__.py
+++ /dev/null
@@ -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")
\ No newline at end of file