添加了API函数以及文档
This commit is contained in:
67
api/README.md
Normal file
67
api/README.md
Normal file
@@ -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 网络桥接 |
|
||||
143
api/__init__.py
Normal file
143
api/__init__.py
Normal file
@@ -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")
|
||||
BIN
api/__pycache__/getxmlimg.cpython-37.pyc
Normal file
BIN
api/__pycache__/getxmlimg.cpython-37.pyc
Normal file
Binary file not shown.
118
api/getxmlimg.py
Executable file
118
api/getxmlimg.py
Executable file
@@ -0,0 +1,118 @@
|
||||
import PIL.Image as Image
|
||||
import PIL.ImageDraw as ImageDraw
|
||||
import zipfile
|
||||
import subprocess
|
||||
import re
|
||||
|
||||
class getsavexml():
|
||||
|
||||
def savexml(self,apkFilePath,xmlpath,iconSavePath):
|
||||
cmddumpid = "aapt dump xmltree "+ apkFilePath + " " + xmlpath
|
||||
print(cmddumpid)
|
||||
xmltree = subprocess.getoutput(cmddumpid)
|
||||
xmls = xmltree.splitlines()
|
||||
# find strs ,print next line
|
||||
def FindStrs(lines,strs):
|
||||
i=0
|
||||
while i < len(lines):
|
||||
if re.search(strs,lines[i]):
|
||||
tmpstr = lines[i+1]
|
||||
i += 1
|
||||
Resultstr = tmpstr.split(":")[-1].split("=")[-1].split("0x")[-1]
|
||||
return Resultstr
|
||||
else:
|
||||
i += 1
|
||||
#从apk的信息中获取前后景图片的ID号
|
||||
backimgid = FindStrs(xmls,"background")
|
||||
foreimgid = FindStrs(xmls,"foreground")
|
||||
print(backimgid)
|
||||
print(foreimgid)
|
||||
|
||||
# 直接从apk resource文件获取前后两层图片路径及ID字符串
|
||||
resource = subprocess.getoutput("aapt dump --values resources " + apkFilePath + "| grep -iE -A1 " + "\"" + backimgid + "|" + foreimgid + "\"")
|
||||
resourcelines = resource.splitlines()
|
||||
print(resourcelines)
|
||||
|
||||
# 从过滤出的字符串中获取所有相同ID的图片路径
|
||||
def Findpicpath(lines,imgid):
|
||||
i=0
|
||||
Resultstr = []
|
||||
while i < len(lines):
|
||||
if re.search(imgid,lines[i]) and re.search("string8",lines[i+1]) :
|
||||
print(lines[i+1])
|
||||
tmpstr = lines[i+1].replace("\"","")
|
||||
i += 1
|
||||
Resultstr.append(tmpstr.split()[-1])
|
||||
else:
|
||||
i += 1
|
||||
return Resultstr
|
||||
|
||||
#获取所有带前后图片ID的图片路径（相同背景或者前景的图片ID但分辨率不一样）
|
||||
backimgs = Findpicpath(resourcelines,backimgid)
|
||||
foreimgs = Findpicpath(resourcelines,foreimgid)
|
||||
print(backimgs)
|
||||
print(foreimgs)
|
||||
#获取分辨率最高的图片路径
|
||||
def getmaxsize(imgs):
|
||||
j = 0
|
||||
size=(0,0)
|
||||
zipapk = zipfile.ZipFile(apkFilePath)
|
||||
imgpath = ""
|
||||
while j < len(imgs):
|
||||
print(imgs[j])
|
||||
img = Image.open(zipapk.open(imgs[j]))
|
||||
print(imgs[j])
|
||||
print(img.size)
|
||||
if size < img.size:
|
||||
size = img.size
|
||||
imgpath = imgs[j]
|
||||
j += 1
|
||||
return imgpath
|
||||
|
||||
# 获取到文件列表后，进行比较分辨率，选取分辨率最高的张图片
|
||||
iconbackpath = getmaxsize(backimgs)
|
||||
iconforepath = getmaxsize(foreimgs)
|
||||
print(iconbackpath + " " + iconforepath)
|
||||
|
||||
#从APK文件获取最终图片
|
||||
zipapk = zipfile.ZipFile(apkFilePath)
|
||||
iconback = zipapk.open(iconbackpath)
|
||||
iconfore = zipapk.open(iconforepath)
|
||||
|
||||
|
||||
# 叠加图片，mask 设置前景为蒙版
|
||||
iconbackimg = Image.open(iconback).convert("RGBA")
|
||||
iconforeimg = Image.open(iconfore).convert("RGBA")
|
||||
iconbackimg.paste(iconforeimg,mask=iconforeimg)
|
||||
|
||||
|
||||
# 圆角图片函数，网上拷贝的
|
||||
def circle_corner(img, radii): #把原图片变成圆角，这个函数是从网上找的，原址 https://www.pyget.cn/p/185266
|
||||
"""
|
||||
圆角处理
|
||||
:param img: 源图象。
|
||||
:param radii: 半径，如：30。
|
||||
:return: 返回一个圆角处理后的图象。
|
||||
"""
|
||||
# 画圆（用于分离4个角）
|
||||
circle = Image.new('L', (radii * 2, radii * 2), 0) # 创建一个黑色背景的画布
|
||||
draw = ImageDraw.Draw(circle)
|
||||
draw.ellipse((0, 0, radii * 2, radii * 2), fill=255) # 画白色圆形
|
||||
# 原图
|
||||
img = img.convert("RGBA")
|
||||
w, h = img.size
|
||||
# 画4个角（将整圆分离为4个部分）
|
||||
alpha = Image.new('L', img.size, 255)
|
||||
alpha.paste(circle.crop((0, 0, radii, radii)), (0, 0)) # 左上角
|
||||
alpha.paste(circle.crop((radii, 0, radii * 2, radii)), (w - radii, 0)) # 右上角
|
||||
alpha.paste(circle.crop((radii, radii, radii * 2, radii * 2)), (w - radii, h - radii)) # 右下角
|
||||
alpha.paste(circle.crop((0, radii, radii, radii * 2)), (0, h - radii)) # 左下角
|
||||
# alpha.show()
|
||||
img.putalpha(alpha) # 白色区域透明可见，黑色区域不可见
|
||||
return img
|
||||
|
||||
# 圆角半径1/8边长,保存icon图片
|
||||
w,h = iconbackimg.size
|
||||
iconimg = circle_corner(iconbackimg,int(w/8))
|
||||
iconimg.save(iconSavePath)
|
||||
|
||||
Reference in New Issue
Block a user