用 Swift 开发 Android 代码：入门指南 – wiki基地

作者： /

用 Swift 开发 Android 代码：入门指南

在移动开发领域，Swift 作为 Apple 平台的首选语言，以其现代化的语法、强大的类型安全和优秀的性能赢得了广泛赞誉。然而，当谈到 Android 开发时，我们通常会想到 Java 或 Kotlin。那么，是否有可能将 Swift 的力量带到 Android 平台，用 Swift 来编写 Android 代码呢？

答案是：可以，但方式并非我们通常理解的原生 Android 应用开发。 你不能像用 Kotlin 或 Java 那样直接使用 Swift 编写 Android 的用户界面（UI）和大部分应用逻辑。Swift 在 Android 上的应用场景主要集中在 共享核心业务逻辑、性能敏感的代码或利用现有的 Swift 库 等方面，通过构建可供 Android 应用（使用 Kotlin 或 Java 编写）调用的本地库（Native Library）来实现。

这篇指南将深入探讨如何利用 Swift 在 Android 生态系统中发挥作用，并提供一个入门级别的视角，理解其基本原理、潜在用途、所需工具以及面临的挑战。

为什么会考虑用 Swift 开发 Android 代码？

在深入技术细节之前，让我们先思考一下，在已经有成熟的 Kotlin 和 Java 生态系统的 Android 平台上，为什么会有人考虑引入 Swift？

  1. 代码共享 (Code Sharing): 这是最主要的原因。对于需要同时开发 iOS 和 Android 应用的团队来说，如果存在一套复杂的业务逻辑、算法、数据处理或网络协议实现，使用同一种语言（如 Swift）编写这部分代码，并使其能在两个平台运行，可以显著减少重复工作，提高开发效率，并确保逻辑一致性。
  2. 利用现有 Swift 库和专业知识: 如果团队或个人已经拥有大量高质量的 Swift 代码库或丰富的 Swift 开发经验，希望在 Android 项目中复用这些资源，而不是用 Kotlin/Java 重写。
  3. 性能需求: 对于某些计算密集型或性能敏感的任务，使用编译为本地代码的 Swift 可能比 Java/Kotlin 获得更好的性能（尽管 Kotlin Native 也在这个领域发力）。
  4. 实验性或特定目的: 在某些特定的研究项目或有独特需求的场景下，可能会探索 Swift 在 Android 上的可能性。

需要再次强调的是，这种方式不是用 Swift 编写整个 Android 应用，而是用 Swift 编写应用中与平台无关的、可复用的部分，然后将这部分代码编译成 Android 可执行的本地库（.so 文件），最后在 Android 应用的 Kotlin/Java 代码中通过 JNI (Java Native Interface) 调用这个本地库。

核心原理： Swift 到 Android 本地库的桥梁

要在 Android 上运行 Swift 代码，我们需要一套机制将 Swift 编译为 Android 目标平台（如 ARM64、x86_64 等）的机器码，并提供一个接口供 Java/Kotlin 调用。这个过程涉及几个关键步骤和技术：

  1. Swift Toolchain for Android: Apple 官方发布的 Swift 工具链主要支持 Apple 平台。要在 Android 上编译 Swift，需要借助社区维护的 Swift for Android 工具链。这个项目致力于将 Swift 编译器移植到 Android 的目标架构上，并提供必要的运行时库。
  2. C 语言作为中间层 (C as the Bridge): Swift 具有优秀的 C 语言互操作性。我们可以将 Swift 函数和数据结构暴露为 C 兼容的接口。这样，Swift 代码就被“包装”在一个 C 接口后面。
  3. Java Native Interface (JNI): JNI 是 Android SDK 的一部分，它允许 Java (以及 Kotlin) 代码与本地应用程序和库（用 C/C++ 等编写）进行交互。我们需要用 C/C++ 编写 JNI 代码，这部分代码负责加载 Swift 编译成的本地库，并将 Java/Kotlin 的方法调用转换为对 Swift（通过 C 接口）的调用，以及在本地代码和 Java/Kotlin 代码之间传递数据。
  4. Android NDK (Native Development Kit): NDK 是一套工具集，允许开发者在 Android 应用中使用 C/C++ 等原生代码。我们将使用 NDK 来构建 JNI 代码，并最终将 Swift 库和 JNI 桥接代码打包到 Android 应用的 APK 或 AAB 文件中。

整个流程可以概括为：
Swift 代码 -> 通过 C 接口暴露 -> 使用 Swift for Android 工具链编译为 Android 目标平台的本地库 (.so) -> 编写 JNI 代码 (C/C++) 作为桥梁 -> 使用 NDK 工具链编译 JNI 代码 -> 将 Swift 库和 JNI 库集成到 Android 项目 -> Kotlin/Java 代码通过 JNI 调用 Swift 功能

入门步骤概述

本指南提供的是一个高层次的入门概念，实际操作涉及复杂的环境配置和构建过程。以下是基本步骤的概述：

  1. 设置开发环境:

    • 安装 Android Studio，并配置好 Android SDK 和 NDK。
    • 获取或构建 Swift for Android 工具链。这通常是社区项目，可能需要额外的配置或依赖。
    • 需要一定的 C/C++ 开发基础，特别是对 JNI 有所了解。

  2. 编写 Swift 代码:

    • 创建 Swift 库项目。
    • 编写你希望在 Android 上运行的业务逻辑代码。
    • 关键一步：使用 @_cdecl 或其他 Swift 特性（如 @objc，虽然 @objc 主要用于 Objective-C 互操作，但在某些场景下也可以考虑配合 C 接口）将 Swift 函数暴露给 C。例如：

    “`swift
    @_cdecl(“swift_add_numbers”) // 暴露给 C 的函数名
    public func addNumbers(a: Int32, b: Int32) -> Int32 {
    return a + b
    }

    // 更复杂的例子：传递字符串
    @cdecl(“swift_process_string”)
    public func processString(     input: UnsafePointer?) -> UnsafeMutablePointer? {
    guard let input = input else { return nil }
    let swiftString = String(cString: input)
    let processedString = “Processed: (swiftString.uppercased())”

    // 将 Swift String 转换回 C String
// 注意：这里需要手动管理内存，返回的指针需要在 Java/Kotlin 侧通过 JNI 释放
let cString = processedString.cString(using: .utf8)
let resultPointer = UnsafeMutablePointer<CChar>.allocate(capacity: cString!.count)
resultPointer.initialize(from: cString!, count: cString!.count)
return resultPointer

    }

    // 内存管理辅助函数，供 JNI 调用释放由 Swift 分配的 C 字符串
    @cdecl(“swift_free_string”)
    public func freeString(     pointer: UnsafeMutablePointer?) {
    pointer?.deallocate()
    }
    ``
    * 注意数据类型的映射：Swift 的 Int、String、Array 等需要转换为 C 兼容的类型（如    Int32,UnsafePointer,void*` 等）。内存管理是跨语言调用的难点，尤其是在 C 接口处。

  3. 构建 Swift 库:

    • 使用 Swift for Android 工具链编译 Swift 代码，生成针对 Android 目标架构的本地库文件（.so）。这个过程可能需要编写构建脚本（如 Shell 脚本、Python 脚本或 CMake 配置）。

  4. 编写 JNI 桥接代码 (C/C++):

    • 在 Android 项目的 jni 或 cpp 目录下创建 C/C++ 源文件。
    • 编写 JNI 函数，这些函数的命名遵循特定规范（Java_包名_类名_方法名）。
    • 在 JNI 函数中，加载 Swift 库 (dlopen) 并调用 Swift 暴露的 C 函数 (dlsym)。
    • 处理 Java/Kotlin 类型与 C/Swift 类型之间的转换。

    “`c++

    include

    include

    include // 用于动态加载库

    // 定义函数指针类型，用于调用 Swift 函数
    typedef int32_t (swift_add_numbers_func)(int32_t a, int32_t b);
    typedef char     (swift_process_string_func)(const char input);
    typedef void (swift_free_string_func)(char pointer);

    // Swift 库的句柄
    void* swiftLibraryHandle = nullptr;

    // 函数指针
    swift_add_numbers_func addNumbersPtr = nullptr;
    swift_process_string_func processStringPtr = nullptr;
    swift_free_string_func freeStringPtr = nullptr;

    extern “C” JNIEXPORT jint JNICALL
    Java_com_your_package_SwiftBridge_addNumbers(
    JNIEnv env,
    jobject /     this */,
    jint a,
    jint b) {

    if (!swiftLibraryHandle) {
     // 尝试加载 Swift 库，库名应与构建生成的 .so 文件对应
     swiftLibraryHandle = dlopen("libSwiftLibrary.so", RTLD_LAZY);
     if (!swiftLibraryHandle) {
         // 处理加载失败错误
         return -1; // 或者抛出 Java 异常
     }
     // 获取函数地址
     addNumbersPtr = (swift_add_numbers_func)dlsym(swiftLibraryHandle, "swift_add_numbers");
     processStringPtr = (swift_process_string_func)dlsym(swiftLibraryHandle, "swift_process_string");
     freeStringPtr = (swift_free_string_func)dlsym(swiftLibraryHandle, "swift_free_string");

     if (!addNumbersPtr || !processStringPtr || !freeStringPtr) {
         // 处理获取函数地址失败错误
         dlclose(swiftLibraryHandle);
         swiftLibraryHandle = nullptr;
         return -1; // 或者抛出 Java 异常
     }
}

// 调用 Swift 函数
if (addNumbersPtr) {
     return addNumbersPtr(a, b);
} else {
     return -1; // 函数未加载
}

    }

    extern “C” JNIEXPORT jstring JNICALL
    Java_com_your_package_SwiftBridge_processString(
    JNIEnv env,
    jobject /     this */,
    jstring input) {

    if (!swiftLibraryHandle || !processStringPtr || !freeStringPtr) {
     // 库或函数未加载，可以尝试在此处加载或返回错误
     return env->NewStringUTF("Error: Swift Library not loaded");
}

// 将 Java String 转换为 C 字符串
const char *c_input = env->GetStringUTFChars(input, 0);

// 调用 Swift 函数
char* c_output = processStringPtr(c_input);

// 释放 Java String 的 C 字符串表示
env->ReleaseStringUTFChars(input, c_input);

if (c_output == nullptr) {
    return nullptr; // Swift 返回 nil
}

// 将 C 字符串转换为 Java String
jstring output_string = env->NewStringUTF(c_output);

// 释放 Swift 分配的 C 字符串内存
freeStringPtr(c_output); // 关键！避免内存泄漏

return output_string;

    }

    // 在合适的时机关闭 Swift 库（例如应用退出时，但通常不必须）
    extern “C” JNIEXPORT void JNICALL
    Java_com_your_package_SwiftBridge_closeSwiftLibrary(
    JNIEnv env,
    jobject /     this */) {
    if (swiftLibraryHandle) {
    dlclose(swiftLibraryHandle);
    swiftLibraryHandle = nullptr;
    addNumbersPtr = nullptr;
    processStringPtr = nullptr;
    freeStringPtr = nullptr;
    }
    }

    ``
    * 需要编写    CMakeLists.txt或Android.mk` 文件来描述如何构建 JNI 代码并将 Swift 库包含到 Android 项目中。

  5. 在 Android 项目中调用 JNI 函数:

    • 在 Kotlin 或 Java 代码中声明 native 方法，使用 native 关键字。
    • 在类的静态初始化块中加载 JNI 库（包含 JNI 桥接代码）。

    “`kotlin
    package com.your.package

    class SwiftBridge {

    // 声明 native 方法，方法签名必须与 JNI 函数名对应
external fun addNumbers(a: Int, b: Int): Int
external fun processString(input: String): String?

companion object {
    init {
        // 加载包含 JNI 桥接代码的库
        // 库名应与 CMakeLists.txt 或 Android.mk 中指定的库名对应
        System.loadLibrary("swift-bridge")
    }
}

    }

    // 在你的 Activity 或其他地方调用
    // val bridge = SwiftBridge()
    // val sum = bridge.addNumbers(5, 7)
    // val processed = bridge.processString(“hello swift”)
    “`

  6. 构建并运行 Android 应用:

    • 使用 Android Studio 构建项目。构建过程会调用 NDK 工具链来编译 JNI 代码，并将 Swift 库和 JNI 库打包到 APK 中。

面临的挑战与局限性

尽管技术上可行，但使用 Swift 开发 Android 代码面临诸多挑战和局限性，使得它目前并非主流或推荐的 Android 开发方式：

  1. 工具链成熟度: Swift for Android 工具链是社区项目，其成熟度、稳定性、文档和支持程度远不如官方的 Swift for Apple 平台工具链或 Android 的 Kotlin/Java 工具链。环境配置可能非常繁琐，且容易遇到不稳定的问题。
  2. 构建系统集成: 将 Swift 的构建过程集成到 Android 的 Gradle 构建系统中是复杂的任务，需要深入理解 Gradle、NDK 构建系统（CMake/ndk-build）以及 Swift 工具链的工作原理。
  3. 互操作性复杂性:
    • 数据类型映射: Swift 的高级数据类型（如 String, Array, Dictionary, Struct, Class, Enum）需要仔细地映射到 C 兼容的类型。处理这些类型在跨语言边界时的转换和生命周期管理是出错的高发区。
    • 内存管理: Swift 使用 ARC (Automatic Reference Counting)，而 C 使用手动内存管理，Java/Kotlin 使用垃圾回收。在 C/JNI 层面进行桥接时，必须非常小心地处理内存的分配和释放，避免内存泄漏或野指针。例如，从 Swift 返回给 C 的指针（如字符串）需要在 JNI 层面负责释放。
    • 错误处理: Swift 的错误处理（throws)、Optionals (?)、协议、泛型等高级特性如何在 JNI 层面优雅地暴露和处理是巨大的挑战。
  4. 调试难度: 跨越 Swift、C/C++ (JNI) 和 Java/Kotlin 三个语言/运行时环境进行调试非常困难，往往需要依赖日志输出或使用专门的调试工具（如 LLDB），且配置复杂。
  5. 缺乏原生 UI 支持: Swift 无法用来编写 Android 的原生 UI（如使用 Compose 或 View 系统）。Swift 代码只能作为后台的计算或逻辑层。
  6. 二进制文件大小: 将 Swift 运行时库打包到 Android 应用中可能会显著增加 APK 的大小，尽管 Swift 社区在减小二进制大小方面一直在努力。
  7. 社区支持: 相比于 Kotlin 或 Java 的 Android 开发，使用 Swift 的社区规模要小得多，遇到问题时寻找解决方案的难度更大。

适合的应用场景

考虑到上述挑战，用 Swift 开发 Android 代码这种方式更适合以下特定场景：

  • 已存在大量核心逻辑由 Swift 实现并需要在 iOS 和 Android 之间共享: 例如，加密算法库、特定网络协议栈、复杂的数据验证或处理逻辑。
  • 性能关键的计算密集型任务: 需要极致性能，且通过 JNI 桥接带来的开销可以接受的场景。
  • 作为 Swift 库作者，希望将库扩展到 Android 平台: 为 Swift 社区贡献者提供将其库移植到 Android 的可能性。

它不适合用于：

  • 开发 Android 用户界面。
  • 编写绝大多数 Android 应用逻辑，特别是与 Android Framework 紧密耦合的部分。
  • 没有跨平台共享代码需求，只是想尝试用 Swift 写 Android 的初学者。

替代方案

如果你主要目的是实现跨平台代码共享，除了 Swift 通过 JNI 的方式，还有其他更成熟或更易于入门的方案值得考虑：

  • Kotlin Multiplatform Mobile (KMM): 使用 Kotlin 编写共享的业务逻辑模块，编译为 iOS 的 Framework 和 Android 的 Jar/AAR 库，然后分别在原生 UI 层调用。这是目前官方推荐的、相对成熟的移动跨平台共享逻辑方案。
  • C++: C++ 是传统的跨平台原生代码编写语言，通过 JNI 调用 C++ 库在 Android 和 iOS 上都有成熟的实践。
  • 跨平台框架 (Flutter, React Native): 这些框架允许使用同一种语言（Dart 或 JavaScript/TypeScript）编写 UI 和逻辑，直接生成 iOS 和 Android 应用。它们是更全面的跨平台解决方案，但通常不涉及编写 Swift 代码。

总结

使用 Swift 开发 Android 代码并非易事，它需要开发者同时掌握 Swift、C/C++ (JNI) 和 Android 开发，并且要应对工具链的不成熟、构建系统的复杂集成以及跨语言交互带来的诸多挑战。

它不是取代 Kotlin 或 Java 成为主流 Android 开发语言的方式，而是一种在特定场景下，通过将 Swift 代码编译为本地库并结合 JNI 调用，实现 iOS 和 Android 之间核心业务逻辑共享的技术方案。

对于大多数 Android 开发者而言，专注于 Kotlin 和 Java 仍然是构建健壮、高效、易于维护的 Android 应用的标准和推荐方式。然而，了解 Swift 在 Android 上的可能性，能为你提供在面对特定跨平台代码共享或性能需求时，多一个潜在的技术选项。

如果你是一名经验丰富的开发者，对 Swift、C/C++ 和 Android NDK 都有深入了解，并且确实有强烈的需求（例如共享一套复杂的、已有的 Swift 业务逻辑），那么探索 Swift for Android 可能会带来显著的收益。但对于初学者，建议先从 Kotlin 或 Java 入门 Android 开发，或者尝试 Kotlin Multiplatform Mobile 等更成熟的跨平台方案。

希望这篇指南能帮助你理解使用 Swift 开发 Android 代码的基本概念、工作原理以及其局限性，为你是否以及如何在你的项目中使用这项技术提供参考。

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部