OleanderPython Windows SDK & Runtime

OleanderPython 是一个用于开发基于 PikaScript 运行时的 Python 应用程序开发工具包（SDK）。它提供了一套完整的开发、构建和部署工具链。

这是 Windows 版本的 SDK & 运行时，支持 64 位和 32 位应用开发和运行。

功能特性

• 多版本 API 支持: 支持多个 API 版本，可根据项目需求选择合适的版本
• 模块化开发: 支持模块化的应用开发架构
• 一键构建: 提供完整的构建脚本，自动编译和打包应用
• JSON5 配置: 使用 JSON5 格式的配置文件，支持注释和更灵活的语法

项目结构

OleanderPython/
├── API1/                    # API 版本目录
│   ├── AppScope/            # 应用作用域配置
│   │   ├── resources/       # 资源文件
│   │   │   └── string/      # 字符串资源
│   │   └── app.json5        # 应用配置
│   ├── entry/               # 入口模块
│   ├── next/                # 其他模块
│   ├── modules/             # API 模块
│   └── build-profile.json5  # 构建配置
├── json5/                   # JSON5 解析库
├── init.py                  # 初始化脚本
├── build.py                 # 构建脚本
├── build.json5              # 构建配置
├── opm.py                   # OleanderPythonApp 包管理器
├── Runtime.exe              # 运行时（64位）
├── Runtime_32bit.exe        # 运行时（32位）
└── LICENSE                  # 许可证文件

快速开始

1. 初始化项目

运行初始化脚本选择 API 版本：

python init.py

按照提示输入需要的 API 版本号（如 1）。

2. 开发应用

在 entry/ 目录下编写你的应用代码：

• main.py - 主入口文件
• module.json5 - 模块配置

3. 构建应用

运行构建脚本编译并打包应用：

python build.py

构建产物将输出到 build/build.opp 文件。

配置文件说明

app.json5

应用级配置文件，定义应用的基本信息和依赖：

{
    "minAPIVersion": 1,      // 最小 API 版本要求
    "targetAPIVersion": 1,   // 目标 API 版本
    "assetAccessGroups": [], // 资源访问组
    // ... 其他配置项
}

build-profile.json5

构建配置文件，定义模块编译顺序和依赖关系：

{
    "modules": [
        {
            "name": "entry",
            "path": "./entry"
        }
    ]
}

module.json5

模块级配置文件，定义单个模块的入口和依赖：

{
    "srcEntry": "main.py",
    "dependencies": []
}

运行时环境

• Runtime.exe: 64 位 Windows 运行时
• Runtime_32bit.exe: 32 位 Windows 运行时

许可证

本项目采用 Apache License 2.0 开源许可证。

相关工具

• pikaPackage.exe: PikaScript 包管理工具
• rust-msc-latest-win10.exe: Rust 编译器（用于构建）

注意事项

1. 构建前请确保已安装 Python 3.7+
2. API 版本需与项目配置的 minAPIVersion 和 targetAPIVersion 匹配
3. 构建过程中如遇到 API 版本不匹配，可选择忽略或切换版本

技术支持

如遇到问题或需要帮助，请联系开发者获取支持。