{"id":20662586,"url":"https://github.com/system233/node-linglong-helper","last_synced_at":"2026-01-07T09:19:57.420Z","repository":{"id":256146429,"uuid":"854437385","full_name":"System233/node-linglong-helper","owner":"System233","description":null,"archived":false,"fork":false,"pushed_at":"2024-09-25T17:03:15.000Z","size":144,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T09:41:41.402Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/System233.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-09T07:06:29.000Z","updated_at":"2024-09-25T17:03:18.000Z","dependencies_parsed_at":"2024-11-16T19:14:44.689Z","dependency_job_id":"33b65d5a-7800-49f5-9672-36f42e831c8f","html_url":"https://github.com/System233/node-linglong-helper","commit_stats":null,"previous_names":["system233/node-linglong-helper"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/System233%2Fnode-linglong-helper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/System233%2Fnode-linglong-helper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/System233%2Fnode-linglong-helper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/System233%2Fnode-linglong-helper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/System233","download_url":"https://codeload.github.com/System233/node-linglong-helper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253415750,"owners_count":21904923,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T19:14:41.536Z","updated_at":"2026-01-07T09:19:57.378Z","avatar_url":"https://github.com/System233.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n Copyright (c) 2024 System233\n\n This software is released under the MIT License.\n https://opensource.org/licenses/MIT\n--\u003e\n\n# ll-helper - 玲珑助手\n\n关于如意玲珑，参见 https://linglong.dev/\n\n## 功能\u0026路线图\n\n- [x] 创建玲珑项目\n - [x] 生成玲珑 DEB 转换项目\n - [x] 通过模板创建项目\n - [x] 可选 .linyaps 包名后缀\n- [x] 依赖管理\n - [x] 筛选并更新 linglong.yaml 依赖项\n - [x] 指定查找依赖的 APT 源\n - [x] APT [auth.conf](https://manpages.debian.org/testing/apt/apt_auth.conf.5.en.html) 支持\n - [x] 指定 base/runime 依赖\n - [x] 指定 base/runtime 依赖包列表\n - [x] 自动检测是否需要引入 runime 依赖\n - [x] 自动化测试缺失依赖 (v0.2.0)\n - [x] 文件名=\u003e包名查找器 (v0.2.0)\n- [x] 图标处理\n - [x] 图标裁剪服务\n - [x] 图标裁剪命令\n- [x] 模块化补丁\n - [x] glib\n - [x] ld (LD_LIBRARAY_PATH)\n - [x] icon\n - [x] java\n - [x] qt\n - [x] qpa\n- [ ] 本地 DEB 输入\n- [ ] 预下载 DEB（解决 ll-builder 不支持 auth.conf 的问题）\n- [ ] 分离补丁仓库\n\n## 安装\u0026使用\n\n```sh\nsudo yarn global add linglong-helper #or npm add linglong-helper -g\n\nll-helper -h\n\nUsage: ll-helper [options] [command]\n\nOptions:\n -h, --help display help for command\n\nCommands:\n create [options] \u003cid\u003e 创建玲珑包工程\n convert [options] \u003cid\u003e 创建DEB包转换项目\n update [options] 更新玲珑项目\n patch \u003cname...\u003e 添加应用补丁\n serve [options] 启动图标裁剪服务\n sharp [options] \u003cinput\u003e 裁剪图片\n resolve [options] 自动化解决隐式依赖\n help [command] display help for command\n```\n\n## 示例\n\n```sh\nll-helper convert com.example.package -f sources.list --name \"Example App Name\" # 创建DEB转制项目\ncd com.example.package.linyaps # 切换到项目目录\nll-helper update # 更新依赖项\n# ll-helper patch ld # 添加LD_LIBRARY_PATH补丁\nll-builder build # 构建项目\nll-builder run # 测试运行\n```\n\n## 项目文件说明\n\n| 名称 | 必选 | 说明 |\n| --------------------- | ----------- | -------------------------------------------------------------------------------- |\n| deps.list | 是 | 依赖包列表，忽略#开头注释 |\n| deps.all.list | 自动生成 | 完整依赖列表 |\n| deps.generated.list | 自动生成 | 需要下载的依赖列表 |\n| auth.conf | 否 | APT [auth.conf](https://manpages.debian.org/testing/apt/apt_auth.conf.5.en.html) |\n| sources.list | 否,自动生成 | APT 源定义列表 |\n| base.packages.list | 否,自动生成 | 基础包环境包列表 |\n| runtime.packages.list | 否,自动生成 | Runtime 包环境包列表 |\n| env.sh | 否 | 构建前环境变量配置 |\n| build.sh | 是 | 构建脚本入口 |\n| install_dep.sh | 是 | 依赖安装脚本 |\n| install_patch.sh | 否 | 补丁安装脚本 |\n| install_start.sh | 是 | 程序入口生成脚本 |\n| patch\\_\\*.sh | 否 | 补丁脚本 |\n\n## env.sh 构建变量\n\n| 名称 | 说明 |\n| ---------------- | ----------------------------------------------- |\n| SHELL_CMD | 应用入口文件，如 ELF、shell 脚本、python 脚本等 |\n| SHELL_EXEC | 执行命令使用的解释器 |\n| ENABLE_USR_PATCH | 若入口文件为脚本，修复其中/usr 路径 |\n\n## 注意\n\n- 不要使用 yarn ll-helper 方法运行，因为 CWD 不在当前目录。\n\n## LICENSE\n\n[MIT LICENSE](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsystem233%2Fnode-linglong-helper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsystem233%2Fnode-linglong-helper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsystem233%2Fnode-linglong-helper/lists"}