7.76 auto-commit

CHANGELOG.txt

@@ -1,3 +1,8 @@
+7.76
+* 修复工具版本依赖
+* 修复 Python 版本匹配问题
+* 更新部分子模块
+
 7.75
 * 新增 OCR识别接口
 * 新增 get_application_by_name

DISCLAIMER.TXT

@@ -1,34 +1,37 @@
-为了下载使用由 rev1si0n (账号 github.com/rev1si0n，邮箱 lamda.devel@gmail.com)（以下简称“本人”）
-个人开发的软件 LAMDA（以下简称“本服务”），您应当阅读并遵守本协议。请您务必审慎阅读、充分理解各条款内容，并选择接受或不接受。
-除非您已阅读并接受本协议所有条款，否则您将无权下载、安装或使用本软件及相关服务。
-您的下载、安装、使用等行为即视为您已阅读并同意受到本声明的约束。
+若您需要获得本服务，您（以下称"用户"）应当同意本协议的全部条款并按照页面上的提示完成全部申请使用程序。您可以在源码或者发布程序中找到 DISCLAIMER.TXT，或者查看以下副本。
+
+为了下载和使用由 firerpa（地址：github.com/firerpa，邮箱：lamda.devel@gmail.com，以下简称“开发者”）开发的 LAMDA 软件（以下简称“本服务”），您必须仔细阅读并同意本协议中的所有条款。请确保您在下载、安装或使用本软件前，已充分理解并同意以下内容。
+在未完全阅读并接受本协议条款之前，您无权下载、安装或使用本软件及其相关服务。一旦您进行下载、安装或使用本软件的操作，即视为您已阅读并同意本协议的全部条款，并愿意遵守其约束。
 
 风险告知：
 本服务需要设备获取 root 权限才能运行，且默认的通讯协议及相关证书文件均为开放信息，这可能会增加您设备被入侵的风险。
-本服务由本人自行开发并使用，可能存在潜在的未知的风险如数据丢失、系统崩溃等，由用户自行决定是否下载、使用本服务。
+本服务可能存在未知的逻辑错误，可能会导致潜在的风险如数据丢失、系统崩溃等，由用户自行决定是否下载、使用本服务。
 
 
 1、本服务设计目的为提高安全分析及测试人员工作效率，应用行为、应用合规分析等。提供的相关工具均为合法合规的APP测试分析、Mock 场景提供。
 本服务本身不提供任何侵入、修改、抓取其他应用内存及网络数据的功能，整合了各大开源框架提供的服务供用户自行选择，方便安全分析人员使用，减少用户的重复性劳动以及管理成本。
 本服务本身不存在盈利性，用户可根据自己需求自行通过下载获取使用，下载及使用过程中不会收取任何费用。
 
-2、本服务尊重并保护用户的个人隐私，不会窃取任何用户设备中的信息。本框架的启动及任何对设备数据读取、存储、传输等权利均在用户自己手中。
+2、本服务尊重并保护用户的个人隐私，不会窃取任何用户设备中的信息。本服务的启动及任何对设备数据读取、存储、传输等权利均在用户自己手中。
 
 3、用户必须在无隐私数据的虚拟设备或者专用设备中使用本服务。在使用本服务时，必须遵守中华人民共和国或者用户所属国家或地区的法律法规，
 不得为任何非法目的而使用本服务，不得利用本服务进行任何不利于他人的行为。
 
 4、用户只可使用本服务进行正规的学习研究或是经过合法授权的应用分析、测试等行为，若用户在使用该软件服务的过程中违背以上原则对第三方造成损失，一切责任由该用户自行承担。
 
-5、任何单位或个人因下载使用本服务而产生的任何意外、疏忽、合约毁坏、诽谤、版权或知识产权侵犯及其造成的损失 (包括但不限于直接、间接、附带或衍生的损失等)，本人不承担任何法律责任。
+5、任何单位或个人因下载使用本服务而产生的任何意外、疏忽、合约毁坏、诽谤、版权或知识产权侵犯及其造成的损失 (包括但不限于直接、间接、附带或衍生的损失等)，开发者不承担任何法律责任。
 
-6、本服务仅供个人、教育、非商业性使用，您同意不会将本服务以及本服务提供的相关服务或接口用于任何商业目的，包括销售、盈利服务或产品开发。
+6、您可以将本服务用于商业用途，但仅限于通过本服务提供的功能、接口或相关服务进行衍生功能扩展或产品开发。您同意，不得将本服务及其相关服务或接口用于任何违反当地法律法规，或从事损害他人利益的行为。
 
-7、用户明确并同意本协议条款列举的全部内容，对使用本服务过程中可能存在的风险和后果由用户自行承担，本人不承担任何法律责任。
+7、用户明确并同意本协议条款列举的全部内容，对使用本服务过程中可能存在的风险和后果由用户自行承担，开发者不承担任何法律责任。
 
-8、本人有权随时对本声明条款及附件内容进行单方面的变更、中断或终止部分或全部本服务的权利。并以消息推送、网页公告等方式予以公布，
+8、开发者有权随时对本声明条款及附件内容进行单方面的变更、中断或终止部分或全部本服务的权利。并以消息推送、网页公告等方式予以公布，
 公布后立即自动生效，无需另行单独通知；若您在本声明内容公告变更后继续使用的，表示您已充分阅读、理解并接受修改后的声明内容。
 
-9、如果本声明的任何部分被认为无效或不可执行，则该部分应以符合相关法律的方式予以修正，以尽可能地反映出本人的原始意图，
-其余部分仍具有完全效力。不可执行的部分声明，并不构成本人放弃执行该声明的权利。
+9、如果本声明的任何部分被认为无效或不可执行，则该部分应以符合相关法律的方式予以修正，以尽可能地反映出开发者的原始意图，
+其余部分仍具有完全效力。不可执行的部分声明，并不构成开发者放弃执行该声明的权利。
+
+10、保留权利：未明示授权的其他一切权利均由开发者所有。
+
 
-10、保留权利：未明示授权的其他一切权利均由本人所有。
+请确认您已阅读并接受本协议所有条款，否则您将无权下载、安装或使用本软件及相关服务。

README.md

@@ -12,11 +12,11 @@
 <img src="https://img.shields.io/github/v/release/rev1si0n/lamda" />
 </p>
 
-<p align="center"><a href="https://device-farm.com/doc/pages/Home.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>
+<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/__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.76"

setup.py

@@ -10,7 +10,7 @@
     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"],

tools/README.md

@@ -1 +1 @@
-使用方法请查看项目 WIKI
+使用方法请查看 https://device-farm.com/doc/

tools/requirements.txt

@@ -1,5 +1,5 @@
 mitmproxy>=9.0.0,<=10.2.0
 dnspython
-httpx[socks]
+httpx[socks]<0.28.0
 packaging
 Pillow

tools/test-fridarpc.js

@@ -3,11 +3,27 @@ Java.perform(function() {
         rpc.exports = {
                 getMyString: function (paramA, paramB) {
                         return performRpcJVMCall(function() {
+                                // 可以使用 Frida java 相关功能，Java.use 等
                                 var newParam = String.$new("helloWorld").toString()
                                 return newParam + ":" + paramA + paramB
                         })
-                }
+                },
+                getMyString1: function (paramA, paramB) {
+                        return performRpcJVMCallOnMain(function() {
+                                // 可以使用 Frida java 相关功能，Java.use 等
+                                // 执行于应用的主进程，适用于涉及到 UI 主线程相关的功能
+                                var newParam = String.$new("helloWorld").toString()
+                                return newParam + ":" + paramA + paramB
+                        })
+                },
+                getMyString2: function (paramA, paramB) {
+                        return performRpcCall(function() {
+                                // 这里不能使用 Java 相关功能
+                                return paramA + paramB
+                        })
+                },
         }
-createFridaRpc("myRpcName", rpc.exports)
+// 创建名为 myRpcName 的调用接口
+createRpcEndpoint("myRpcName", rpc.exports)
 console.log("fridarpc test loaded")
 });