跳转到内容
Skip 中文站
文档 应用展示 博客 开发装备 赞赏
3.2k

快速入门

开发设备准备

Section titled “开发设备准备”

模拟器足以完成初次体验；准备开始真机调试时，再考虑 Android 测试设备和具备数据传输能力的 USB-C 配件。

推广链接说明：以下链接为 Amazon Associates 联盟链接。通过链接完成符合条件的购买后，本站可能获得佣金，你的购买价格不会因此增加。

Android 测试设备

用于真机检查不同屏幕尺寸、系统版本、深色模式、无障碍和平台交互。优先选择可解锁、仍能获得系统更新的机型。

查看 Android 测试设备推广链接 · Amazon.com 美国站

USB-C 扩展与连接

连接 Android 真机、外接显示器与调试配件。选购时注意数据传输规格、供电能力和端口组合。

查看 USB-C 扩展设备推广链接 · Amazon.com 美国站

As an Amazon Associate I earn from qualifying purchases.

  1. 安装 Xcode ↗

  2. 安装 Android Studio ↗

  3. 安装 Homebrew ↗

  4. Homebrew 设置完成后，在终端中运行以下命令安装 Skip：

    Terminal window
    brew install skip

    该命令会下载并安装 skip 工具本身，以及构建和运行 Android 版应用所必需的 Android SDK 与 gradle 构建工具。

  5. 运行以下命令，检查基础开发环境是否满足要求：

    Terminal window
    skip checkup
    [✓] Skip version 1.7.0 (= 1.7.0)
    [✓] macOS version 15.7.2 (> 13.5.0)
    [✓] macOS architecture: ARM
    [✓] Swift version 6.2.3 (> 5.9.0)
    [✓] Swiftly version 1.0.1 (> 1.0.0)
    [✓] Xcode version 26.2 (> 15.0.0)
    [✓] Xcode tools SDKs: 5
    [✓] Homebrew version 5.0.9 (> 4.1.0)
    [✓] Gradle version 9.2.1 (> 8.6.0)
    [✓] Java version 25.0.1 (> 17.0.0)
    [✓] Android Debug Bridge version 1.0.41 (> 1.0.40)
    [✓] Resolve dependencies (10.43s)
    [✓] Build hello-skip (56.08s)
    [✓] Test Swift (15.43s)
    [✓] Test Kotlin (26.19s)
    [✓] Check project schemes (5.65s)
    [✓] Archive iOS ipa (13.13s)
    [✓] Assemble HelloSkip-debug.ipa 175 KB
    [✓] Verifying HelloSkip-debug.ipa: 175 KB
    [✓] Assembling Android apk (61.1s)
    [✓] Verify HelloSkip-debug.apk: 80 MB
    [✓] Check Skip Updates: 1.7.0
    [✓] Skip checkup succeeded in 190.21s

    如果安装或检查失败，可以使用 skip checkup --verbose 重试并查看更详细的信息。也可以在常见问题 中查找常用解决方案，或前往 Slack 和讨论论坛 ↗ 向社区求助。

  6. 使用以下命令创建新的 Skip 应用项目：

    Terminal window
    skip create

    命令行会通过一系列问题引导你设置要创建的应用。其中最关键的两个选择是：

    1. App 还是 Library？ App 选项会创建一个 Swift + SwiftUI 应用，并使用 Skip 的 Xcode 插件自动构建 Android 版本。Library 选项则会创建一个 Swift 库，它可以用在统一的 Skip 应用中，也可作为独立 iOS 和 Android 应用 的共享业务逻辑。无论选哪种，最终应用都可以混合使用 Swift 与 Kotlin、SwiftUI 与 Compose。
    2. Skip Fuse 还是 Skip Lite？ 两种模式的详细区别见原生与转译模式 文档。本示例会创建 Skip Fuse 应用，它使用官方 Swift SDK for Android ↗。

    如果你刚接触 Skip，建议先从 App 项目开始。下面演示如何创建 hello-skip/HelloSkip 项目（生成的项目与最精简的 Skip Fuse 示例应用 ↗ 或 Skip Lite 示例应用 ↗ 一致）：

    Terminal window
    $ skip create
    

    Welcome to Skip!
    

    Select type of project to create:
      1: App: mobile application for Android and iOS
      2: Library: library project with one or more modules
    Enter selection (default: App) [1..2] 1
    

    Select the mode of the project:
      1: Skip Fuse: natively compiled project
      2: Skip Lite: transpiled project
    Enter selection [1..2] 1
    

    Enter the project-name for the App: hello-skip
    

    Enter the CamelCase name of the App module: HelloSkip
    

    Optionally enter additional module names:
    

    Enter the app bundle identifier: com.example.HelloSkip
    

    Create a free open-source project? (y/n) [n]: n
    Initialize git repository for the project? (y/n) [n]: n
    Initialize a Fastlane configuration for the project? (y/n) [y]: y
    Pre-build the project? (y/n) [y]: y
    Install the Swift Android SDK? (y/n) [y]: y
    Open the Xcode project after initialization? (y/n) [y]: y
    

    [✓] Install Swift Android SDK (48.4s)
    [✓] Resolve dependencies (12.12s)
    [✓] Build hello-skip (53.35s)
    [✓] Check project schemes (6.12s)
    [✓] Archive iOS ipa (17.18s)
    [✓] Assemble HelloSkip-debug.ipa 1 MB
    [✓] Verifying HelloSkip-debug.ipa: 1 MB
    [✓] Assembling Android apk (78.91s)
    [✓] Verify HelloSkip-debug.apk: 80 MB
    [✓] Opening Xcode project (0.10s)
    [✓] Skip create succeeded in 168.63s

    其他方式

    也可以使用无交互的 skip init 命令创建 Skip 项目，详情参阅命令行参考。

  7. 应用预构建完成并在 Xcode 中打开后，就_几乎_可以开始了。还剩一步：创建并启动 Android 模拟器。它相当于 Android 世界的 iPhone Simulator，用于本地应用开发。skip 提供了一条命令，可为当前项目快速安装并配置 Android 模拟器：

    Terminal window
    skip android emulator create
      [✓] Configure Android SDK Manager (1.55s)
      [✓] Install platform-tools (0.77s)
      [✓] Install emulator (0.75s)
      [✓] Install platforms;android-34 (0.76s)
      [✓] Install system-images;android-34;google_apis;arm64-v8a (0.75s)
      [✓] Create emulator: emulator-34-medium_phone (0.76s)
      [✓] Create Android emulator succeeded in 5.35s

    命令成功完成后，Android 模拟器即已安装。使用以下命令可启动模拟器并查看日志输出：

    Terminal window
    skip android emulator launch

  8. 现在可以启动新应用了！在 Xcode 中，确认已选择“HelloSkip App” scheme 和一个模拟器目标（例如“iPhone 17”），然后运行该 scheme。

    系统可能会提示你对 Skip 插件执行“Trust and Enable”。确认后，项目会同时构建并启动到 iPhone Simulator 和 Android Emulator。

    Screenshot of Skip running in both the iOS Simulator and Android Emulator

后续步骤

Section titled “后续步骤”

恭喜！你已经创建并启动了第一个双平台应用。现在可以尝试修改项目并重新启动，观察 Skip 如何融入你日常的“编辑—构建—运行”循环。

接下来可以：

  • 加入 Skip Slack，与 Skip 开发者社区交流。
  • 浏览 Skip 示例应用，了解常见设计模式与最佳实践。
  • 在 Swift Package Index ↗ 中确认你喜欢的 Swift 包是否在数千个 Android 可用包之列，并浏览各种 Skip 集成框架，扩展双平台应用的能力。
  • 阅读方案对比指南，了解 Skip 相对 Flutter 和 React Native 等跨平台框架的优势。
  • 阅读应用开发 文档，学习如何使用 Skip 开发。
  • 探索 Skip 可以创建的其他项目类型，包括多模块应用、转译应用，以及在独立 iOS 和 Android 应用之间共享业务逻辑。
  • 根据项目需求判断 Skip Fuse 还是 Skip Lite 更合适。
  • 阅读术语表，熟悉使用 Skip 进行 Android 应用开发时可能遇到的新术语。
  • 如果想将现有应用引入 Skip，请阅读迁移指南。

更新 Skip

Section titled “更新 Skip”

将 skip 命令行工具更新到最新版本：

Terminal window
skip upgrade

要让 Xcode 项目使用 Package.swift 配置允许的最新 Skip 插件和库版本，请在 Xcode 中选择 File -> Packages -> Update to Latest Package Versions。

其他资源

Section titled “其他资源”
  • 运行 skip help 查看 skip 工具的完整命令列表，也可参阅命令行参考。
  • 在通用帮助 页面查找故障排查和联系方式。
  • 继续浏览本文档，进一步学习 Skip 开发。