QPython 是一款专为 Android 系统设计的 Python 集成开发与运行环境，它将 Python 解释器、代码编辑器、控制台以及一系列便捷工具整合在一个图形化应用中，使得在手机上编写、运行和调试 Python 脚本变得简单直观 [ref_1][ref_3][ref_5]。其核心优势在于降低了移动端 Python 编程的门槛，提供了比纯命令行环境（如 Termux）更友好的图形界面 [ref_1][ref_3]。 ### **一、核心功能模块详解** 启动 QPython 应用后，主界面通常包含多个功能图标，每个模块对应一项核心功能。以下是其主要模块的功能说明： | 模块图标/名称 | 主要功能 | 使用场景与说明 | | :--- | :--- | :--- | | **`QEdit` (编辑器)** | 内置的代码编辑器，支持语法高亮、自动缩进和代码提示。 | 用于编写和修改 Python 脚本 (.py 文件)。是创建新项目和编写代码的主要场所 [ref_2][ref_5]。 | | **`Console` (控制台)** | 交互式 Python 命令行环境 (REPL)。 | 用于快速执行单行 Python 命令、测试代码片段或进行简单的计算，类似于电脑上的 Python Shell [ref_1]。 | | **`Program` (程序)** | 脚本管理器，列出已保存的 Python 脚本。 | 点击即可直接运行已编写的脚本。方便管理和快速启动常用程序 [ref_2][ref_6]。 | | **`QPyPI` / **`PIP`** | 第三方库管理工具。`QPyPI` 是图形化库商店，`PIP` 是命令行工具。 | **安装库**：在 `QPyPI` 中搜索库名（如 `requests`）并点击安装，或在 `PIP` 控制台输入 `pip install <库名>` [ref_2]。这是扩展 QPython 功能（如爬虫、数据分析）的关键步骤。 | | **`SL4A`** | (Scripting Layer for Android) 允许 Python 脚本调用 Android 原生 API。 | 用于开发与手机硬件交互的应用，例如读取通讯录、发送短信、获取GPS位置、控制振动器等 [ref_3][ref_5]。 | | **`FTP` 服务** | 启动一个 FTP 服务器，用于在电脑和手机之间无线传输文件。 | **文件传输**：在 QPython 中启动 FTP 服务，在电脑的浏览器或 FTP 客户端输入显示的地址（如 `ftp://192.168.x.x:2121`），即可上传下载脚本文件，极大方便了代码同步 [ref_1][ref_2][ref_4]。 | ### **二、完整使用流程：从安装到运行第一个脚本** #### **步骤 1：安装与启动** 1. 从官方渠道（如 Google Play Store、腾讯应用宝、华为应用市场）或 QPython 官网下载 `QPython 3L`（Python 3 版本）的 APK 文件并安装 [ref_1][ref_4]。 2. 安装完成后，点击桌面图标启动应用。首次启动可能会请求存储权限，需允许以正常读写脚本文件。 #### **步骤 2：编写第一个脚本** 1. 在主界面点击 **`QEdit`** 图标进入编辑器。 2. 点击右上角的 “+” 号或类似的新建按钮，创建一个新文件，命名为 `hello.py`。 3. 在编辑区输入以下经典代码： ```python # hello.py - 第一个QPython脚本 print("Hello, QPython World!") # 尝试一个简单计算 a = 10 b = 20 print(f"{a} + {b} = {a + b}") # 尝试使用Android SL4A功能（需确保有相应权限） import androidhelper droid = androidhelper.Android() droid.makeToast("你好，来自QPython的提示！") # 在屏幕上显示一个短暂的提示框 ``` #### **步骤 3：运行脚本** 编写完成后，保存文件。退出编辑器，回到主界面。 * **方法一（通过`Program`运行）**：点击 **`Program`** 图标，在列表中找到 `hello.py`，点击它即可执行。输出结果将显示在随后弹出的运行窗口中。 * **方法二（在`Console`中运行）**：点击 **`Console`** 图标，在命令行中输入 `exec(open(‘/sdcard/qpython/scripts3/hello.py’).read())` （具体路径可能因版本而异）来执行。 #### **步骤 4：安装第三方库（以爬虫库`requests`为例）** 若脚本需要网络请求，则需安装 `requests` 库。 * **图形化安装（推荐）**： 1. 在主界面点击 **`QPyPI`** 图标。 2. 在顶部的搜索框中输入 `requests`。 3. 在搜索结果中找到 `requests` 库，点击右侧的 “安装” 按钮。等待安装完成提示即可 [ref_2]。 * **命令行安装**： 1. 在主界面点击 **`PIP`** 或 **`终端`** 图标。 2. 在命令行中输入 `pip install requests` 并回车，等待安装完成 [ref_2]。 安装成功后，即可在脚本中 `import requests` 并使用。 #### **步骤 5：电脑与手机间传输文件（使用FTP）** 为了在电脑上更高效地编写代码，然后传输到手机运行，可以使用内置的 FTP 功能。 1. **在手机上启动服务**：在 QPython 主界面点击 **`FTP`** 图标。应用会显示一个 FTP 服务器地址，例如 `ftp://192.168.1.100:2121`，以及可能的用户名和密码（通常为 `qpython`）[ref_1][ref_4]。 2. **在电脑上连接**： * **方法A（浏览器）**：在电脑浏览器的地址栏直接输入显示的 FTP 地址（如 `ftp://192.168.1.100:2121`），按回车。根据提示输入用户名和密码，即可像访问文件夹一样管理手机上的脚本目录。 * **方法B（FTP客户端）**：使用 FileZilla、WinSCP 等 FTP 客户端软件，输入手机显示的 IP、端口、用户名和密码进行连接。 3. **传输文件**：连接成功后，你可以将电脑上写好的 `.py` 文件直接拖拽到手机的 `scripts3`（Python3脚本默认目录）文件夹中，反之亦可 [ref_4]。 ### **三、应用开发与高级用途** QPython 不仅限于运行脚本，还可用于更复杂的项目开发 [ref_5]： 1. **Web 应用开发**：可以运行轻量级 Web 框架（如 Bottle、Flask）的代码，将手机变成一个临时的 Web 服务器 [ref_4][ref_5]。 ```python # 一个简单的Flask应用示例 (需先通过QPyPI安装flask) from flask import Flask app = Flask(__name__) @app.route('/') def hello(): return ‘<h1>Hello from QPython Flask Server!</h1>’ if __name__ == ‘__main__’: app.run(host=‘0.0.0.0’, port=8080, debug=True) ``` 运行此脚本后，在同一局域网内的其他设备浏览器中访问 `http://<手机IP地址>:8080` 即可看到页面。 2. **Android 应用原型开发**：通过 **`SL4A`** 模块，可以调用丰富的 Android API，快速制作具备原生功能的应用原型 [ref_3][ref_5]。 ```python # 使用SL4A获取手机电池信息并语音播报 import androidhelper import time droid = androidhelper.Android() # 获取电池状态 battery = droid.batteryGetStatus().result level = battery.get(‘level’, ‘未知’) # 组织消息 message = f“当前电量剩余 {level} percent.” # 显示Toast提示 droid.makeToast(message) # 使用TTS语音播报 droid.ttsSpeak(message) time.sleep(2) ``` 3. **游戏与图形程序**：支持 `kivy`、`pygame` 等库，可以开发简单的移动端图形应用或游戏 [ref_4]。 ### **四、注意事项与局限性** * **性能与兼容性**：手机硬件资源有限，不适合运行计算密集型或超大规模爬虫任务。部分依赖特定系统底层或需要编译的 Python 库可能无法安装或运行不稳定 [ref_6]。 * **输入效率**：在手机触摸屏上编写大量代码效率较低，建议复杂项目在电脑上编辑，通过 FTP 同步到手机进行测试和运行 [ref_2][ref_4]。 * **版本选择**：`QPython` 对应 Python 2.7，`QPython 3L` 对应 Python 3.x。新项目建议选择 `QPython 3L` 以获得更好的语言特性和库支持 [ref_1][ref_5]。 * **文件路径**：脚本默认存储路径通常为 `/sdcard/qpython/scripts3/`（Python3），在代码中读写文件时应注意使用正确的路径。 总之，QPython 作为一个高度集成的移动端 Python 平台，通过其图形化界面和丰富的内置工具，极大地便利了在 Android 设备上进行 Python 学习、脚本编写、自动化任务和小型应用开发。对于需要调用手机硬件功能或进行轻量级原型验证的场景尤为实用 [ref_3][ref_5]。