企业官网建设流程全解析

如何从源码构建Phoenix钱包：Android和iOS双平台编译教程

【免费下载链接】phoenixPhoenix is a self-custodial Bitcoin wallet using Lightning to send/receive payments.项目地址: https://gitcode.com/gh_mirrors/phoenix2/phoenix

Phoenix是一款由ACINQ开发的自托管比特币钱包，通过闪电网络实现快速、低成本的比特币收发功能。本教程将详细介绍如何从源码构建适用于Android和iOS平台的Phoenix钱包应用，让你轻松掌握开源钱包的编译方法。

准备工作：编译环境搭建

在开始构建Phoenix钱包前，需要确保你的开发环境满足以下要求：

• Android平台：需安装Android Studio，推荐用于开发跨平台共享模块phoenix-shared
• iOS平台：需安装Xcode，用于iOS应用的编译和调试

Phoenix钱包的核心功能依赖于ACINQ开发的lightning-kmp库，该库包含比特币和闪电网络协议的实现。根据gradle/libs.version.toml文件显示，当前使用的lightning-kmp版本为1.12.0。如果遇到快照版本，可能需要参考其官方文档自行构建。

图1：Phoenix钱包使用闪电网络进行快速支付

第一步：获取源码

首先克隆Phoenix项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/phoenix2/phoenix cd phoenix

项目结构包含三个主要模块：

• phoenix-shared：Kotlin跨平台业务逻辑模块，包含数据库查询等共享代码
• phoenix-android：Android应用UI，使用Kotlin和Jetpack Compose开发
• phoenix-ios：iOS应用UI，使用Swift开发

第二步：构建Android应用

基本构建步骤

1. 打开Android Studio，导入整个phoenix项目
2. 等待Gradle同步完成，确保所有依赖项正确下载
3. 选择phoenix-android模块，点击Build > Make Project

跳过Android构建（仅iOS开发）

如果仅需要构建iOS应用，可以在项目根目录创建local.properties文件，并添加：

skip.android=true

Docker构建发布版本

对于正式发布版本，Phoenix提供了Docker化构建流程：

1. 构建Docker镜像（首次执行约20分钟）：

   docker build -t phoenix_build .

2. 生成APK文件（约10分钟）：

   # macOS/Linux docker run --rm -v $(pwd):/home/ubuntu/phoenix/phoenix-android/build/outputs -w /home/ubuntu/phoenix phoenix_build ./gradlew :phoenix-android:assembleRelease # Windows docker run --rm -v ${pwd}:/home/ubuntu/phoenix/phoenix-android/build/outputs -w //home/ubuntu/phoenix phoenix_build ./gradlew :phoenix-android:assembleRelease

3. 生成的APK文件将位于apk文件夹中

图2：Phoenix钱包的自托管特性让你完全掌控自己的资金

第三步：构建iOS应用

使用Xcode构建

1. 打开phoenix-ios/phoenix-ios.xcodeproj项目
2. 等待项目索引和依赖解析完成
3. 选择目标设备或模拟器，点击Product > Build

共享模块自动构建

iOS构建过程中会自动处理phoenix-shared模块：

• 通过构建阶段自动生成PhoenixShared.framework
• 确保Kotlin Multiplatform代码正确桥接到Swift

常见问题解决

Lightning-kmp版本问题

如果gradle/libs.version.toml中指定的lightning-kmp版本带有snapshot标记，需要：

1. 自行构建lightning-kmp开发版本
2. 可能需要根据API变化调整Phoenix代码

资源分配问题

在Windows系统上使用Docker构建时，建议：

• 增加Docker的内存分配
• 确保足够的磁盘空间（至少20GB）

项目结构与核心模块

Phoenix采用清晰的模块化设计：

• 共享逻辑：phoenix-shared/包含跨平台业务逻辑
• Android UI：phoenix-android/src/main/kotlin/fr/acinq/使用Jetpack Compose构建
• iOS UI：phoenix-ios/phoenix-ios/views/包含SwiftUI界面组件

图3：Phoenix结合比特币和闪电网络技术

总结

通过本教程，你已经了解了从源码构建Phoenix钱包的完整流程。无论是Android还是iOS平台，Phoenix都提供了清晰的构建路径。作为一款自托管钱包，Phoenix让你完全掌控自己的比特币资金，同时通过闪电网络实现高效的支付体验。

如果你想进一步参与项目开发，可以参考TRANSLATION.md贡献翻译，或通过提交PR改进代码库。构建过程中遇到问题，可查阅项目的FAQ或寻求社区支持。

【免费下载链接】phoenixPhoenix is a self-custodial Bitcoin wallet using Lightning to send/receive payments.项目地址: https://gitcode.com/gh_mirrors/phoenix2/phoenix