Python

在设备端 Python 服务器上运行 Python 项目;WebView 指向本地端口。

适用场景

Flask、Django、FastAPI、Tornado 应用,或内置 HTTP 服务器。

运行时

• 版本 —— Python 3.14。
• 框架 —— Flask、Django、FastAPI(uvicorn)、Tornado、内置 HTTP 服务器。
• 依赖 —— pip 解析进 .pypackages;支持自定义原生扩展。
• 版本化 —— 二进制名带版本号,未来升级不会写死路径。
• 在 Linux 环境和运行时管理界面管理。

核心配置

由 PythonAppConfig 支撑。

项目

• 项目(projectId/projectName、sourceProjectPath)—— Python 源码。
• 框架(framework)—— 识别出的框架(若有)。
• Python 版本(pythonVersion)。

入口与服务器

• 入口文件(entryFile)—— 默认 app.py。
• 入口模块(entryModule)—— 用于模块式入口(如 main:app)。
• 服务器类型(serverType)—— 按检测到的框架自动推导(FastAPI→uvicorn、Django→gunicorn、其余→builtin),导入项目时自动配置,无需手动选择。
• 端口(serverPort)—— 通过端口管理分配。
• 环境变量(envVars)—— 传给进程的键值对。

依赖与扩展

• requirements 文件(requirementsFile)—— 默认 requirements.txt。文件为空,或只有注释和 pip 选项时,不会启动安装。
• 含 pip 依赖(hasPipDeps)—— 依赖是否解析进 .pypackages。
• 自定义原生扩展(customPythonExtensions)—— 添加 .so 扩展,各带加载顺序。