第1章 跨平台SDK概述
很多人一听到“跨平台SDK”就觉得是写一次、到处跑的银弹。说实话，我最早也这么想——那会儿刚接手一个iOS+Android双端项目，两套代码、两拨人、两个发版节奏，光是UI对齐就让我崩溃了好几次。后来接触了Flutter和React Native，才意识到跨平台SDK远不止“少写代码”这么简单。这一章咱们先把概念聊透，再谈谈它是怎么从原始时代一路折腾到今天的。
1.1 什么是跨平台SDK
定义不复杂：一个跨平台SDK是一套软件开发工具包，它让你用同一套代码（或接近同一套）构建出能在多个操作系统或硬件平台运行的应用程序。比如你用Flutter写的App，一份Dart代码可以编译成iOS上的原生二进制、Android上的APK，甚至桌面和Web。
但这里有个坑：“一次编写，到处运行”是个理想状态。实际项目中，你一定需要处理平台差异——比如iOS的刘海屏、Android的返回键、不同版本的API行为。我个人习惯把跨平台SDK分成三类：
- 桥接型（如React Native、Xamarin）—— 通过JS或C#调用原生组件，UI渲染依赖平台控件
- 自绘制引擎型（如Flutter、Qt）—— 自带渲染引擎，跳过平台控件，像素级一致性
- Web混合型（如Cordova、Capacitor）—— 用WebView包裹HTML/CSS/JS，性能受限但上手快
嗯，这里要注意：选择哪种类型直接决定了你的性能和原生能力边界。我在项目中遇到过团队选了Web混合型做复杂动画，结果卡成PPT，后来连夜迁到Flutter才救回来。
1.2 发展历程：从“双胞胎噩梦”到“一次编码，处处调试”
我2014年刚入行时，iOS和Android还是两个世界。那时候有个段子：一个iOS开发和一个Android开发坐在一起，他们中间隔着一堵墙——代码复用？不存在的。那时候所谓“跨平台”就是Cordova（PhoneGap），用WebView包一个网页，体验嘛…你懂的。
后来出了Xamarin，用C#写原生UI，但Mono运行时打包体积巨大，社区也小。真正的转折点是2015年React Native发布，它用React的声明式UI + JS Bridge调用原生组件，一下子火了。我记得当时公司立项时讨论了很久，最后还是选了原生开发，因为React Native的桥接性能还不稳定，而且第三方库经常出现版本冲突。
再往后，2017年Flutter横空出世，Dart语言 + Skia自绘引擎，性能直接对标原生。我曾经用Flutter替客户做过一个电商App，60帧丝滑，同一份代码同时上线iOS和Android，开发周期缩短了40%。不过也有槽点——Dart生态当初太弱，很多功能要自己造轮子。
现在2025年，跨平台SDK已经相当成熟。Flutter、React Native、Kotlin Multiplatform、SwiftUI（Apple自家也支持跨平台）…每个都有自己的定位。你想想看，本质上我们追求的不是“完全一致”，而是“高效地处理80%的通用逻辑，优雅地留下20%的平台专属”。
| 阶段 | 代表SDK | 核心思想 | 我的体验关键词 |
|---|---|---|---|
| 2010–2014 | Cordova, Unity（游戏） | WebView包裹HTML | 慢、卡、原生能力受限 |
| 2014–2017 | Xamarin, React Native | JS/C#桥接原生 | 性能有提升，但桥接有坑 |
| 2017–2022 | Flutter, Kotlin Multiplatform | 自绘引擎 / 共享逻辑 | 真·跨平台，生态爆炸 |
| 2022–今 | Flutter 3+, SwiftUI, MAUI | 全平台 + 可折叠设备 | 稳定、成熟、大厂背书 |
1.3 典型应用场景归纳
跨平台SDK到底用在哪儿？我把平时项目里见过的场景捋了捋：
- 快速原型 / Demo验证 —— 启动一个Flutter项目，三周出双端MVP，跑通业务逻辑再考虑重写。我用Flutter帮创业公司做过一个MVP，老板当场拍板后续就用这套。
- 企业级内部工具 —— 后台管理、门店扫码、工单系统这类对性能不敏感但需要覆盖安卓和iOS的App，用React Native或者Flutter都很划算。记得有一次帮客户做巡检系统，Flutter开发两个月，维护三年。
- 嵌入式 / IoT配网 —— 智能家居、蓝牙网关的配网App，通常需要在手机上显示设备状态。Flutter对蓝牙的支持已经很完善，我自己做过一个IoT配网Demo，写了不到1000行Dart就搞定。
- 电商 / 社交主流应用 —— 很多头部App（比如阿里闲鱼、拼多多、字节部分应用）都在用Flutter或React Native做部分页面。注意是“部分页面”而非全量迁移，他们利用跨平台SDK的热更新和快速迭代能力。
- 桌面 + 移动 + Web全屏覆盖 —— Flutter Web和React Native for Windows已经可以跑在生产环境了。我去年给一个零售公司做POS系统，用Flutter同时覆盖iPad、Windows和Web，代码复用率超80%。
说了这么多，你可能已经感觉到：跨平台SDK不是银弹，但它是现代多平台开发的基础设施。选择它还是原生，取决于你的团队能力、性能要求、平台差异接受度。我个人习惯先把核心业务逻辑用跨平台SDK实现，保留原生通道做平台特性。
图里这个层次结构，就是大多数跨平台SDK的通用骨架。你从上往下看：最上面是应用界面，中间是跨平台抽象层把差异化包装起来，底层通过桥接”翻译“成平台原生API。嗯，理解了这个图，以后你去看任何一个跨平台SDK的架构文档，都能快速定位它属于哪种设计。
好了，这一章我们先聊到这儿。跨平台SDK的世界很大，后面我们会深入到兼容性测试的每个环节——你会见识到真实项目中那些奇奇怪怪的碎片化问题，以及怎么用系统化的方法去搞定它们。