hc_bundle

用于从源工作目录和清单文件创建DNA、hApp和web-hApp捆绑文件的工具，反之亦然。 这个crate为hc CLI工具定义了三个独立的子命令，每种捆绑类型一个。 所有子命令都非常相似，具有几乎相同的标志和选项。

这个crate还为每个子命令定义了独立的二进制文件：hc-dna、hc-app和hc-web-app。

hc app和hc web-app非常相似，唯一的区别是增加了--recursive标志。 如果使用这个标志，它会首先尝试打包要包含在正在打包的捆绑包中的所有资源。 如果找不到指定的捆绑DNA或hApp资源，按照惯例它会在同一目录中查找DNA或hApp清单文件，并尝试使用指定的名称打包它。

示例代码

以下是一个完整的使用示例，展示如何使用holochain_cli_bundle来创建和部署去中心化应用：

// 首先安装holochain_cli_bundle
// cargo install holochain_cli_bundle

use std::path::PathBuf;
use std::process::Command;

fn main() {
    // 创建一个DNA bundle
    let dna_path = PathBuf::from("./my_dna");
    let dna_output = PathBuf::from("./my_dna.dna");
    
    Command::new("hc-dna")
        .arg("pack")
        .arg(dna_path)
        .arg("--output")
        .arg(dna_output)
        .status()
        .expect("Failed to pack DNA");

    // 创建一个hApp bundle
    let happ_path = PathBuf::from("./my_happ");
    let happ_output = PathBuf::from("./my_happ.happ");
    
    Command::new("hc-app")
        .arg("pack")
        .arg(happ_path)
        .arg("--output")
        .arg(happ_output)
        .status()
        .expect("Failed to pack hApp");

    // 创建一个web-hApp bundle
    let web_happ_path = PathBuf::from("./my_web_happ");
    let web_happ_output = PathBuf::from("./my_web_happ.webhapp");
    
    Command::new("hc-web-app")
        .arg("pack")
        .arg(web_happ_path)
        .arg("--output")
        .arg(web_happ_output)
        .arg("--recursive")  // 递归打包所有依赖
        .status()
        .expect("Failed to pack web-hApp");

    println!("All bundles created successfully!");
}

完整示例demo

以下是基于上述示例的扩展完整demo，展示如何在实际项目中使用hc_bundle：

// 导入所需模块
use std::path::PathBuf;
use std::process::Command;
use std::fs;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 检查并创建输出目录
    let output_dir = PathBuf::from("./bundles");
    if !output_dir.exists() {
        fs::create_dir(&output_dir)?;
    }

    // 1. 打包DNA
    let dna_source = PathBuf::from("./dna_source");
    let dna_output = output_dir.join("my_app.dna");
    
    if !Command::new("hc-dna")
        .arg("pack")
        .arg(&dna_source)
        .arg("--output")
        .arg(&dna_output)
        .status()?
        .success() {
            return Err("Failed to pack DNA".into());
        }

    // 2. 打包hApp (包含多个DNA)
    let happ_source = PathBuf::from("./happ_source");
    let happ_output = output_dir.join("my_app.happ");
    
    if !Command::new("hc-app")
        .arg("pack")
        .arg(&happ_source)
        .arg("--output")
        .arg(&happ_output)
        .status()?
        .success() {
            return Err("Failed to pack hApp".into());
        }

    // 3. 打包web-hApp (包含UI和hApp)
    let web_happ_source = PathBuf::from("./web_app");
    let web_happ_output = output_dir.join("my_web_app.webhapp");
    
    if !Command::new("hc-web-app")
        .arg("pack")
        .arg(&web_happ_source)
        .arg("--output")
        .arg(&web_happ_output)
        .arg("--recursive")  // 递归打包所有依赖
        .status()?
        .success() {
            return Err("Failed to pack web-hApp".into());
        }

    println!("Successfully created all bundles in {:?}", output_dir);
    Ok(())
}

// 测试用例
#[cfg(test)]
mod tests {
    use super::*;
    use std::process::Command;
    
    #[test]
    fn test_hc_dna_pack() {
        let status = Command::new("hc-dna")
            .arg("--version")
            .status()
            .expect("hc-dna command failed to start");
        
        assert!(status.success(), "hc-dna command should be available");
    }
}

贡献

Holochain是一个开源项目。我们欢迎各种形式的参与，并积极努力扩大接受参与的范围。请参阅我们的贡献指南，了解我们在社区参与的一般做法和协议，以及关于代码格式化、测试实践、持续集成等的具体期望。

许可证

版权所有 © 2019 - 2024, Holochain Foundation

本程序是自由软件：您可以根据许可证条款重新分发和/或修改它，许可证在LICENSE文件（Apache 2.0）中提供。本程序分发时希望它有用，但不提供任何担保；甚至没有适销性或针对特定用途的适用性的暗示担保。