Han1mePlus多平台构建指南:Android、iOS、macOS、Windows、Linux打包全流程

发布时间:2026/11/3 18:20:47
Han1mePlus多平台构建指南:Android、iOS、macOS、Windows、Linux打包全流程 【免费下载链接】Han1mePlus​一款基于 Flutter Dart 构建的跨平台 Hanime1 第三方客户端支持 Android、iOS、macOS 及 Windows。项目地址https://gitcode.com/gh_mirrors/ha/Han1mePlus点击查看免费下载Han1mePlus 是一款基于 Flutter Dart 构建的 Hanime1 跨平台第三方客户端支持 Android、iOS、macOS、Windows 与 Linux 五大平台。本文是一份 Han1mePlus 多平台构建与打包的完整指南从环境准备到各平台的编译、签名与安装包生成带你一步步完成 Han1mePlus 全平台打包流程即使是 Flutter 新手也能照着做。构建前环境准备所有平台通用在开始任何平台的构建之前先准备好以下三样东西工具版本要求说明Flutter SDKStable 渠道Dart SDK ≥ 3.11.0见 pubspec.yaml 中的sdk: 3.11.0 4.0.0Dart SDK随 Flutter 自带无需单独安装各平台原生工具链Android SDK / Xcode / VS2022 / GTK3详见下文各章节克隆仓库git clone https://gitcode.com/gh_mirrors/ha/Han1mePlus.git cd Han1mePlus检查工具链是否就绪flutter doctor flutter pub get应用版本号集中在 pubspec.yaml当前为1.2.425打包前如需发布新版本先在这里修改version。 提示项目启用了generate: true与flutter_localizationsflutter pub get会自动生成多语言简中、英文、繁中见 lib/l10n/代码无需手动处理。Android 打包APK 与 AAB 一键构建Han1mePlus 的 Android 端最低支持 Android 8.1API 27目标与编译 SDK 均为 37相关配置位于 android/app/build.gradle.kts。构建环境使用 Gradle 9.0.0gradle-wrapper.properties与 AGP 8.13.0。构建步骤# Debug 版可直接安装 flutter build apk --debug # Release 版推荐分发用 AAB体积更小、可上架 flutter build appbundle --release产物位置APKbuild/app/outputs/flutter-apk/app-release.apkAABbuild/app/outputs/bundle/release/app-release.aab两个值得注意的细节Release 签名当前配置中 release 构建直接复用 debug 签名android/app/build.gradle.kts 的signingConfig signingConfigs.getByName(debug)并启用了 R8 压缩isMinifyEnabled。若要上架应用商店请替换为自己的正式签名。体积优化debug 包会自动剔除armeabi-v7a、x86、x86_64架构的 so 库android/app/build.gradle.kts 中的androidComponents配置只保留arm64-v8a加快调试编译速度。原生代码Android 端还包含 Kotlin 原生类如 EchHttpClient.kt 的 ECH 网络客户端Gradle 会自动一并编译无需额外操作。iOS 打包从 pod install 到 IPA 导出iOS 构建只能在 macOS 上进行需要 Xcode 与 CocoaPods。iOS 端包含多个 Swift 原生组件网络、DNS、代理等位于 ios/Runner/如 Han1meHttpClient.swift。构建步骤cd ios pod install cd .. # 生成 ipa需先配置签名 flutter build ipa --release关键点说明ios/Podfile 使用use_frameworks!动态库模式集成 CocoaPodspod install必须在flutter pub get之后执行它依赖Generated.xcconfig。ios/Runner/Info.plist 已开启NSAllowsArbitraryLoads允许非 HTTPS 请求并声明了 Face ID 解锁的用途描述——这与应用内的应用锁功能lib/src/features/auth/配套无需额外修改。签名配置在 Xcode 中打开ios/Runner.xcworkspace选择 Runner 目标 → Signing Capabilities填入你的 Team 与 Bundle ID。个人测试可用免费账号生成开发证书发布到 TestFlight / App Store 需要付费开发者账号。构建完成后.xcarchive位于build/ios/archive/用 Xcode Organizer 即可导出 IPA。macOS 打包一条命令生成 .appmacOS 端与 iOS 共享大部分 Swift 代码构建更简单——不需要手动 pod installFlutter 工具链会托管整个过程Pod 配置见 macos/Podfile。构建步骤flutter build macos --release产物为build/macos/Build/Products/Release/Han1me.app可直接双击运行或拖入「应用程序」文件夹。注意事项最低系统要求macos/Podfile 声明platform :osx, 12.0即 macOS 12 Monterey 及以上。应用标识显示名为Han1me、Bundle ID 为com.liar.han1mePlus定义在 macos/Runner/Configs/AppInfo.xcconfig。公证Notarization分发给他人时建议进行签名 公证否则用户首次打开会被 Gatekeeper 拦截仅供自己使用的本地构建可以忽略。Windows 打包MSBuild 编译 Inno Setup 安装包Windows 端采用 CMake Visual Studio 2022 构建编译配置见 windows/CMakeLists.txt入口代码在 windows/runner/main.cpp。构建步骤# 前提安装 Visual Studio 2022勾选“使用 C 的桌面开发” flutter build windows --release产物目录为build\windows\x64\runner\Release\包含han1me_plus.exe及全部运行库。制作安装程序仓库自带 Inno Setup 脚本 windows/installer.iss会打包 Release 目录内容生成Han1mePlus-Setup.exe安装包并支持创建桌面快捷方式windows/installer.iss。只需安装 Inno Setup 后用其打开脚本编译即可。注意若只打包绿色版免安装目录需要把Release目录整体复制分发其中的data\flutter_assets与动态库不可省略。Linux 打包GTK3 依赖与可移植目录Linux 端依赖 CMake 与 GTK 3.0linux/CMakeLists.txt 通过 pkg-config 检查 GTK# Debian / Ubuntu sudo apt install clang cmake ninja-build pkg-config \ libgtk-3-dev libnotify-dev libwebkit2gtk-4.0-dev # 构建 flutter build linux --release产物说明最终产物是build/linux/x64/release/bundle/目录可整体压缩分发包含han1me_plus可执行文件、lib、data与share子目录。构建时会自动安装桌面集成资源my_application.desktop 启动项与 com.liar.han1meplus.png 图标见 linux/CMakeLists.txt用户安装后应用列表即可正常显示 Han1me 图标。若需制作 .deb 或 .AppImage 安装包可自行基于bundle/目录用dpkg-deb或appimagetool封装仓库未内置该脚本。常见构建问题速查平台症状解决方法全部flutter doctor报工具链缺失按提示安装对应 SDKiOS 构建必须使用flutter build ipa前先在终端确认 CocoaPods 已安装pod --version全部依赖拉取失败项目含 ECHlib/src/data/remote/ech/等原生依赖首次flutter pub get较慢属正常现象请检查网络代理Androidflutter.sdk not set in local.properties由 Android Studio 打开项目让其自动生成或手动在android/local.properties中写入 Flutter SDK 路径iOS / macOSPod 相关报错删除ios/Pods、ios/Podfile.lock后重新flutter pub getpod installWindowsCMake 找不到编译器确认安装了 VS2022 的 C 桌面开发组件或在 VS 开发者终端中执行构建LinuxCould not find pkg-config/ GTK 报错安装libgtk-3-dev、pkg-config参考上文命令总结五平台构建命令一览平台构建命令产物Androidflutter build appbundle --releaseAAB上架/flutter build apk出 APKiOSflutter build ipa --release.xcarchive→ 导出 IPAmacOSflutter build macos --releaseHan1me.appWindowsflutter build windows --releaseRelease 目录 / Inno Setup 安装包Linuxflutter build linux --release可移植 bundle 目录掌握以上内容你就完成了 Han1mePlus 全平台构建日常自测推荐先打 Android APK 或桌面端 Release 版验证功能再按目标平台补齐签名与安装包。项目入口逻辑可参考 lib/main.dart应用启动时会初始化播放器引擎、设置存储与 shader 资源复制理解它有助于排查各平台的启动异常。⚠️ 本项目遵循 AGPL v3.0 协议见 LICENSE二次分发时请遵守协议条款本应用为非官方客户端请自行确保使用合规。赞分享【免费下载链接】Han1mePlus​一款基于 Flutter Dart 构建的跨平台 Hanime1 第三方客户端支持 Android、iOS、macOS 及 Windows。项目地址https://gitcode.com/gh_mirrors/ha/Han1mePlus点击查看免费下载相关推荐Wails多平台构建指南Windows、macOS和Linux一键打包Wails多平台构建指南Windows、macOS和Linux一键打包 Wails是一个强大的跨平台桌面应用开发框架让开发者能够使用Web技术JavaSc桌面应用跨平台前端移动开发ZLMediaKit多平台支持Linux/Windows/macOS/iOS/Android全平台编译指南ZLMediaKit多平台支持Linux/Windows/macOS/iOS/Android全平台编译指南 前言 还在为流媒体服务在不同平台上的编译部署而头疼音视频直播后端视频electron-builder 跨平台构建完全指南macOS / Linux / Windows 多平台打包与 Docker 实战electron builder 跨平台构建完全指南macOS / Linux / Windows 多平台打包与 Docker 实战 导读 本篇指南以 ele构建工具桌面应用开发工具上一篇百川云平台集成指南CloudWalker Platform批量检测API实战下一篇Citra 3DS模拟器使用指南免费安装、导入ROM、卡帧排查一步到位创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询