开源项目pyzule-rw使用教程

1. 项目的目录结构及介绍

pyzule-rw项目的目录结构如下：

pyzule-rw/
├── .github/
│   └── ISSUE_TEMPLATE
├── cgen
├── cyan
├── .gitignore
├── .ruff.toml
├── LICENSE
├── MANIFEST.in
├── README.md
├── setup.py

• .github/: 存放GitHub Actions相关的文件，例如ISSUE_TEMPLATE用于定义提交issue时的模板。
• cgen: 用于生成.cyan配置文件的脚本。
• cyan: 项目的主执行文件，用于注入deb、dylib、framework等文件到iOS应用中。
• .gitignore: 定义哪些文件和目录应该被Git忽略。
• .ruff.toml: 配置文件，用于定义静态代码分析工具ruff的规则。
• LICENSE: 项目的许可证文件。
• MANIFEST.in: 指定打包时包含的文件列表。
• README.md: 项目的自述文件，包含项目介绍、使用方法和安装说明等。
• setup.py: 用于安装Python包的配置文件。

2. 项目的启动文件介绍

项目的启动文件是cyan。当你想要运行项目时，需要在安装了Python 3.9或更高版本的终端中执行以下命令：

python cyan.py

这个脚本负责主要的逻辑，包括读取配置文件、处理用户输入的命令以及执行相应的文件注入操作。

3. 项目的配置文件介绍

项目的配置主要通过.cyan文件来进行，这个文件可以由cgen脚本来生成。配置文件中包含了注入操作所需的各项参数，如：

• 要注入的文件路径
• 注入的目标应用
• 修改应用信息（如应用名称、版本、bundle id等）

配置文件的一个示例可能如下所示：

[global]
app_path = /path/to/app.ipa
output_path = /path/to/output.ipa

[bundle]
name = "New App Name"
version = "1.0.0"
bundle_id = "com.example.newapp"

[entitlements]
<key>application-identifier</key>
<string>$(TeamIdentifierPrefix)com.example.newapp</string>

通过编辑这个配置文件，用户可以自定义注入过程的各种参数，从而满足不同的需求。