Rust应用打包工具apple-bundles的使用，快速构建和分发macOS/iOS应用的Rust插件库

apple-bundles 是一个实现了与 Apple bundles 相关功能的库 crate。bundle 是 Apple 操作系统中用于封装代码和资源的基础原语（例如 /Applications 中的 .app 目录就是应用程序 bundle）。

安装

在项目目录中运行以下 Cargo 命令：

cargo add apple-bundles

或者在 Cargo.toml 中添加：

apple-bundles = "0.21.0"

使用示例

以下是一个完整的使用示例，展示如何使用 apple-bundles 创建一个基本的 macOS 应用程序 bundle：

use apple_bundles::{
    Bundle, 
    DirectoryBundle,
    InfoPlist,
    InfoPlistKey,
    InfoPlistValue
};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 创建 Info.plist 内容
    let mut info_plist = InfoPlist::new();
    info_plist.insert(
        InfoPlistKey::CFBundleExecutable.to_string(), 
        InfoPlistValue::String("my_app".to_string())
    );
    info_plist.insert(
        InfoPlistKey::CFBundleIdentifier.to_string(), 
        InfoPlistValue::String("com.example.myapp".to_string())
    );
    info_plist.insert(
        InfoPlistKey::CFBundleName.to_string(), 
        InfoPlistValue::String("My App".to_string())
    );
    info_plist.insert(
        InfoPlistKey::CFBundleVersion.to_string(), 
        InfoPlistValue::String("1.0".to_string())
    );
    info_plist.insert(
        InfoPlistKey::CFBundleShortVersionString.to_string(), 
        InfoPlistValue::String("1.0".to_string())
    );

    // 创建应用程序 bundle
    let bundle = DirectoryBundle::new("MyApp.app")
        .with_info_plist(info_plist)?
        .with_executable("target/release/my_app")?;

    // 写入文件系统
    bundle.write_to("dist")?;

    println!("Successfully created application bundle at dist/MyApp.app");
    Ok(())
}

创建 Framework Bundle 示例

use apple_bundles::{
    Bundle,
    FrameworkBundle,
    InfoPlist,
    InfoPlistKey,
    InfoPlistValue
};

fn create_framework() -> Result<(), Box<dyn std::error::Error>> {
    // 创建 Info.plist 内容
    let mut info_plist = InfoPlist::new();
    info_plist.insert(
        InfoPlistKey::CFBundleIdentifier.to_string(),
        InfoPlistValue::String("com.example.myframework".to_string())
    );
    info_plist.insert(
        InfoPlistKey::CFBundleName.to_string(),
        InfoPlistValue::String("MyFramework".to_string())
    );
    info_plist.insert(
        InfoPlistKey::CFBundleVersion.to_string(),
        InfoPlistValue::String("1.0".to_string())
    );
    info_plist.insert(
        InfoPlistKey::CFBundlePackageType.to_string(),
        InfoPlistValue::String("FMWK".to_string())
    );

    // 创建 Framework bundle
    let framework = FrameworkBundle::new("MyFramework.framework")
        .with_info_plist(info_plist)?
        .with_library("target/universal/release/libmyframework.dylib")?;

    // 写入文件系统
    framework.write_to("dist")?;

    println!("Successfully created framework at dist/MyFramework.framework");
    Ok(())
}

功能特点

• 支持创建标准的 Apple bundle 结构
• 提供类型安全的 Info.plist 操作接口
• 支持应用程序 bundle 和 framework bundle
• 可扩展支持其他 bundle 类型

完整示例代码

以下是一个结合应用程序 bundle 和 framework bundle 的完整示例：

use apple_bundles::{
    Bundle,
    DirectoryBundle,
    FrameworkBundle,
    InfoPlist,
    InfoPlistKey,
    InfoPlistValue
};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 创建应用程序 bundle
    let mut app_info_plist = InfoPlist::new();
    app_info_plist.insert(
        InfoPlistKey::CFBundleExecutable.to_string(),
        InfoPlistValue::String("my_app".to_string())
    );
    app_info_plist.insert(
        InfoPlistKey::CFBundleIdentifier.to_string(),
        InfoPlistValue::String("com.example.myapp".to_string())
    );
    app_info_plist.insert(
        InfoPlistKey::CFBundleName.to_string(),
        InfoPlistValue::String("My App".to_string())
    );
    app_info_plist.insert(
        InfoPlistKey::CFBundleVersion.to_string(),
        InfoPlistValue::String("1.0".to_string())
    );

    let app_bundle = DirectoryBundle::new("MyApp.app")
        .with_info_plist(app_info_plist)?
        .with_executable("target/release/my_app")?;

    // 创建 framework bundle
    let mut framework_info_plist = InfoPlist::new();
    framework_info_plist.insert(
        InfoPlistKey::CFBundleIdentifier.to_string(),
        InfoPlistValue::String("com.example.myframework".to_string())
    );
    framework_info_plist.insert(
        InfoPlistKey::CFBundleName.to_string(),
        InfoPlistValue::String("MyFramework".to_string())
    );
    framework_info_plist.insert(
        InfoPlistKey::CFBundleVersion.to_string(),
        InfoPlistValue::String("1.0".to_string())
    );
    framework_info_plist.insert(
        InfoPlistKey::CFBundlePackageType.to_string(),
        InfoPlistValue::String("FMWK".to_string())
    );

    let framework = FrameworkBundle::new("MyFramework.framework")
        .with_info_plist(framework_info_plist)?
        .with_library("target/universal/release/libmyframework.dylib")?;

    // 写入文件系统
    app_bundle.write_to("dist")?;
    framework.write_to("dist")?;

    println!("Successfully created bundles in dist/ directory");
    Ok(())
}

许可证

MPL-2.0