lamda 7.75__tar.gz → 7.80__tar.gz

{lamda-7.75 → lamda-7.80}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lamda
-Version: 7.75
+Version: 7.80
 Summary: Android reverse engineering & automation framework (Client API)
 Home-page: https://github.com/firerpa/lamda
 Author: rev1si0n
@@ -12,7 +12,7 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: Android
 Classifier: Topic :: Security
-Requires-Python: >=3.6,<=3.12
+Requires-Python: >=3.6,<3.13
 Requires-Dist: grpcio-tools<=1.68.0,>=1.35.0
 Requires-Dist: grpc-interceptor<=0.15.4,>=0.13.0
 Requires-Dist: grpcio<=1.68.0,>=1.35.0

{lamda-7.75 → lamda-7.80}/README.md

@@ -12,11 +12,11 @@
 <img src="https://img.shields.io/github/v/release/rev1si0n/lamda" />
 </p>
 
-<p align="center"><a href="https://github.com/rev1si0n/lamda/wiki">使用文档</a> | <a href="https://t.me/lamda_dev">TELEGRAM</a> | <a href="https://lamda.run/join/qq">QQ 群组</a> | <a href="https://github.com/rev1si0n/lamda/blob/HEAD/CHANGELOG.txt">更新历史</a></p>
+<p align="center"><a href="https://device-farm.com/doc/index.html">使用文档</a> | <a href="https://t.me/lamda_dev">TELEGRAM</a> | <a href="https://lamda.run/join/qq">QQ 群组</a> | <a href="https://github.com/rev1si0n/lamda/blob/HEAD/CHANGELOG.txt">更新历史</a></p>
 
 智能机的崛起，传统网页端的普及度也开始显著减弱，数据与应用正加速向移动端转移。越来越多的人选择通过智能手机和平板等移动设备来获取信息和服务。随着移动设备的普及，用户享受到更便捷、更即时的访问体验，传统的网页内容消费模式面临重新审视。与此同时，数据采集的技术也亟需适应这一趋势。过去，许多数据采集工具专注于网页内容，但在移动端环境中，尤其是在移动端封闭的黑盒中，现今的常规采集技术也面临着新的挑战。LAMDA 的诞生，为这一切创造了可能。
 
-LAMDA 是一个**安卓领域的集大成者框架**，设计为减少**安全分析**及**应用测试**工作的时间和琐碎问题，为**移动端RPA数据采集**提供稳定的解决方案，以**编程化**的**接口**替代大量手动操作，**易部署**，没有那些复杂花哨不跨平台的安装流程，你所需要的能力他大概率能做到并且做的更好。他并不是一个单一功能的框架，他是集 Appium、uiautomator **自动化**的超集同时具备**逆向**领域如 **Hook** **抓包** **证书安装** **组网** **API跟踪** **手机自控** 等等各种能力的框架。为了让你大概了解它的用处：你是否会在手机上安装各类代理、插件或者点来点去的设置来完成你的工作？你是否要在异地操作远在千里之外的手机？你是否有编程控制手机的需求？是否还在某些云手机厂商那里购买昂贵的 **IP切换**、**远程ADB调试**、**RPA自动化**甚至连 **logcat 日志** 都要付费的服务？如果有，那么对了，只需一个 LAMDA 即可解决所有问题。并且，他更注重**分布式**，事实上，你可以在一台公网服务器上管理散布在世界各地各种网络环境中的设备。当然，LAMDA 可以做到的远不止于此，你可以阅读使用文档尽情探索他的所有能力。
+LAMDA 是一个**安卓领域的集大成者**，设计为减少**安全分析**及**应用测试**工作的时间和琐碎问题，为**移动端RPA数据采集**提供稳定的解决方案，以**编程化**的**接口**替代大量手动操作，**易部署**，没有那些复杂花哨不跨平台的安装流程，你所需要的能力他大概率能做到并且做的更好。他并不是一个单一功能的框架，他是集 Appium、uiautomator **自动化**的超集同时具备**逆向**领域如 **Hook** **抓包** **证书安装** **组网** **API跟踪** **手机自控** 等等各种能力的框架。为了让你大概了解它的用处：你是否会在手机上安装各类代理、插件或者点来点去的设置来完成你的工作？你是否要在异地操作远在千里之外的手机？你是否有编程控制手机的需求？是否还在某些云手机厂商那里购买昂贵的 **IP切换**、**远程ADB调试**、**RPA自动化**甚至连 **logcat 日志** 都要付费的服务？如果有，那么对了，只需一个 LAMDA 即可解决所有问题。并且，他更注重**分布式**，事实上，你可以在一台公网服务器上管理散布在世界各地各种网络环境中的设备。当然，LAMDA 可以做到的远不止于此，你可以阅读使用文档尽情探索他的所有能力。
 
 <p align="center"><b>长期维护及更新，质量稳定，安全可靠，生产环境可用<br>现稳定应用于多个外部大型系统，包括自动化取证，云平台，数据采集，涉诈应用分析系统等<br>本框架已稳定运行于各种数据生产环境五年以上</b></p>
 
@@ -33,11 +33,6 @@ LAMDA 是一个**安卓领域的集大成者框架**，设计为减少**安全
 
 <p align="center">LAMDA 提供多达 160 条编程 API 接口，让你可以对安卓设备进行无微不至的管理和操作，提供了包括命令执行，系统设置，系统状态，应用相关，自动化相关，代理以及文件等十几个大类的接口。同时提供了封装完整的 Python 库让你可以快速上手使用。</p>
 
-<p align="center">
-<img src="image/api.png" alt="动图演示" width="95%">
-</p>
-
-
 <h3><p align="center">简洁易用的远程桌面</p></h3>
 
 <p align="center">

{lamda-7.75 → lamda-7.80}/lamda/__init__.py

@@ -2,4 +2,4 @@
 #
 # Distributed under MIT license.
 # See file LICENSE for detail or copy at https://opensource.org/licenses/MIT
-__version__ = "7.75"
+__version__ = "7.80"

{lamda-7.75 → lamda-7.80}/lamda/client.py

@@ -256,6 +256,11 @@ TouchSequence.appendUp = touchSequenceAppendUp
 TouchSequence.__getitem__ = touchSequenceIndexer
 TouchSequence.__iter__ = touchSequenceIter
 
+DataEncode = protos.DataEncode
+ScriptRuntime = protos.ScriptRuntime
+HookRpcRequest = protos.HookRpcRequest
+HookRpcResponse = protos.HookRpcResponse
+
 Bound.width = property(width)
 Bound.height = property(height)
 
@@ -960,6 +965,24 @@ class UiAutomatorStub(BaseServiceStub):
         return ObjectUiAutomatorOpStub(self.stub, kwargs)
 
 
+class AppScriptRpcInterface(object):
+    def __init__(self, stub, application,
+                                    name):
+        self.application = application
+        self.stub = stub
+        self.name = name
+    def __call__(self, *args):
+        call_args = dict()
+        call_args["method"] = self.name
+        call_args["args"] = args
+        req = HookRpcRequest()
+        req.package = self.application.applicationId
+        req.callinfo = json.dumps(call_args)
+        result = self.stub.callScript(req)
+        r = json.loads(result.callresult)
+        return r
+
+
 class ApplicationOpStub:
     def __init__(self, stub, applicationId, user=0):
         """
@@ -1114,6 +1137,51 @@ class ApplicationOpStub:
         req.user = self.user
         r = self.stub.isInstalled(req)
         return r.value
+    def attach_script(self, script, runtime=ScriptRuntime.RUNTIME_QJS,
+                                                    emit="",
+                                encode=DataEncode.DATA_ENCODE_NONE,
+                                standup=5):
+        """
+        向应用注入持久化 Hook 脚本
+        """
+        s = isinstance(script, str)
+        script = script.encode() if s else script
+        req = protos.HookRequest()
+        req.package     = self.applicationId
+        req.script      = script
+        req.runtime     = runtime
+        req.standup     = standup
+        req.destination = emit
+        req.encode      = encode
+        r = self.stub.attachScript(req)
+        return r.value
+    def detach_script(self):
+        """
+        移除注入应用的 Hook 脚本
+        """
+        req = protos.String(value=self.applicationId)
+        r = self.stub.detachScript(req)
+        return r.value
+    def is_attached_script(self):
+        """
+        检查使用在此应用注入了 Hook 脚本
+        """
+        req = protos.String(value=self.applicationId)
+        r = self.stub.isScriptAttached(req)
+        return r.value
+    def is_script_alive(self):
+        """
+        检查应用中的 Hook 脚本是否正常
+        """
+        req = protos.String(value=self.applicationId)
+        r = self.stub.isScriptAlive(req)
+        return r.value
+    def __getattr__(self, name):
+        """
+        调用注入应用 Hook 脚本的导出方法
+        """
+        return AppScriptRpcInterface(self.stub, self,
+                                            name)
 
 
 class ApplicationStub(BaseServiceStub):

{lamda-7.75 → lamda-7.80}/lamda/rpc/application.proto

@@ -13,6 +13,16 @@ enum GrantType {
                 GRANT_IGNORE      = 2;
 }
 
+enum DataEncode {
+        DATA_ENCODE_NONE  = 0;
+        DATA_ENCODE_ZLIB  = 1;
+}
+
+enum ScriptRuntime {
+        RUNTIME_QJS        = 0;
+        RUNTIME_V8         = 1;
+}
+
 message ApplicationRequest {
         string name             = 1;
         string permission       = 2;
@@ -83,3 +93,22 @@ message ApplicationProcesses {
 message ApplicationPkgNames {
         repeated string names   = 1;
 }
+
+message HookRequest {
+        string package          = 1;
+        bytes script            = 2;
+        ScriptRuntime runtime   = 3;
+        string destination      = 4;
+        DataEncode encode       = 5;
+        uint32 standup          = 6;
+}
+
+message HookRpcRequest {
+        string package          = 1;
+        string callinfo         = 2;
+}
+
+message HookRpcResponse {
+        string package          = 1;
+        string callresult       = 2;
+}

{lamda-7.75 → lamda-7.80}/lamda/rpc/services.proto

@@ -50,6 +50,12 @@ service Application {
     rpc addToDozeModeWhiteList(ApplicationRequest) returns (Boolean) {}
     rpc removeFromDozeModeWhiteList(ApplicationRequest) returns (Boolean) {}
     rpc getIdentifierByLabel(String) returns (String) {}
+
+    rpc callScript(HookRpcRequest) returns (HookRpcResponse) {}
+    rpc isScriptAlive(String) returns (Boolean) {}
+    rpc isScriptAttached(String) returns (Boolean) {}
+    rpc attachScript(HookRequest) returns (Boolean) {}
+    rpc detachScript(String) returns (Boolean) {}
 }
 
 service Debug {

{lamda-7.75 → lamda-7.80}/lamda.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lamda
-Version: 7.75
+Version: 7.80
 Summary: Android reverse engineering & automation framework (Client API)
 Home-page: https://github.com/firerpa/lamda
 Author: rev1si0n
@@ -12,7 +12,7 @@ Classifier: Intended Audience :: Science/Research
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: Android
 Classifier: Topic :: Security
-Requires-Python: >=3.6,<=3.12
+Requires-Python: >=3.6,<3.13
 Requires-Dist: grpcio-tools<=1.68.0,>=1.35.0
 Requires-Dist: grpc-interceptor<=0.15.4,>=0.13.0
 Requires-Dist: grpcio<=1.68.0,>=1.35.0

{lamda-7.75 → lamda-7.80}/setup.py

@@ -10,7 +10,7 @@ setuptools.setup(
     description     = "Android reverse engineering & automation framework (Client API)",
     url             = "https://github.com/firerpa/lamda",
     author          = "rev1si0n",
-    python_requires = ">=3.6,<=3.12",
+    python_requires = ">=3.6,<3.13",
     zip_safe        = False,
     extras_require  = {
         "full": ["frida>=16.0.0,<17.0.0"],