# h5pack-core

**Repository Path**: cskchensk_admin/h5pack-core

## Basic Information

- **Project Name**: h5pack-core
- **Description**: h5pack 是一个跨平台(支持mac/windows)的app打包工具，只需简单的配置和一个指令，即可将 H5 直接打包成 Android APK
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-10-17
- **Last Updated**: 2025-10-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<br>

<h1 align="center">Welcome to h5pack 👋</h1>

<br>

即兴的产物，h5pack 是一个跨平台(支持 mac/windows)的 app 打包工具，只需简单的配置和一个指令，即可将 H5 直接打包成 Android APK

## 效果

一个常规的网页，可将其打包为一个 App

<img width="1615" alt="image" src="https://github.com/user-attachments/assets/9528fa98-7ee1-4b9a-96a5-ec0e1593b126" />

打包效果

<img width="907" alt="image" src="https://github.com/user-attachments/assets/65983db4-b7ca-4e54-939b-22e276e1f0f9" />

App 效果

<img width="802" alt="image" src="https://github.com/user-attachments/assets/482385ca-491f-4c3f-9c5e-7e910daa86a8" />

[视频效果](https://image.jimmyxuexue.top/video/27_1721291477.mp4)

GitHub:h5pack-core [传送门](https://github.com/Jimmylxue/h5pack-core)

> issues 是第一生产力！😄

知识星球：[传送门](http://www.jimmyxuexue.top)

> 大兄弟们聚过来，这件事很重要 🎉🎉🎉

(如果觉得不错 👍，给个 star ⭐ 吧，你的认可是我最大的动力 ！)

## 使用：

1. 安装

```
pnpm add -D h5pack
```

2. 配置

项目根目录下新建 `h5pack.json` 并做如下配置：

> 具体配置信息见:[传送门](http://www.jimmyxuexue.top:999/snowtiny/usage/config.html)

```json
{
	"entry": "./dist", // h5项目打包入口
	"name": "newApp", // app包名
	"splash": "./public/vite.svg", // app splash 启动页logo
	"output": "./", // 打包完成后app 输出位置
	"log": false, // 是否开启完整打包日志
	"registry": "github", // github||gitee  资源镜像下载的地址，如因代理问题可以配置为gitee
	"logo": "./src/assets/splash.svg" // app 在桌面显示的logo
}
```

在`package.json` 中增加如下脚本：

```json
"scripts": {
  "compress": "npx h5pack"
}
```

3. 运行

```
npm run compress
```

## 相关依赖

App 的打包依赖于另外一个仓库 [h5pack-native](https://github.com/Jimmylxue/h5pack-native) 使用的同学需要安装最基础的安卓环境

- `node20`、`yarn`
- `javaJDK17`
- `Android SDK Platform 34`

具体环境可以看[参考文档](https://reactnative.dev/docs/0.73/environment-setup?platform=android)

## example

example 中有两个 示例。simple 版本和 docker 版本

[simple](https://github.com/Jimmylxue/h5pack-core/tree/main/example/simple)：适用于宿主机有安卓环境，可按照上面相关依赖自行安装依赖

[docker](https://github.com/Jimmylxue/h5pack-core/tree/main/example/docker)：docker 处理好了所有的环境，可基于 docker 进行打包

## 其他内容

不定期在 B 站直播写代码，欢迎有兴趣的小伙伴们前来围观，期待你们的关注~

[B 站个人主页](https://space.bilibili.com/304985153?spm_id_from=333.1007.0.0)

我有个前端交流群，平时大家一起讨论技术和交流 bug，有兴趣的小伙伴欢迎加入。（vx 添加：ysh15120）