完成小目标

有些小激动，完成3个月前定的小目标：发布开源库react-native-mapa v1.0.0

npm: www.npmjs.com/package/rea…

git: github.com/cnmapos/rea…

为什么要开源

在地图行业工作也有好几年，不同公司对地图开发普遍存在重复造车轮问题，虽说地图开源库不算少，但偏底层，落地到业务易用性打了折扣。另一个原因是后续自己想开发地产品。因此有了想打造一款国内最好用的react native地图开源库，同时支持IOS和Android。

v1.0.0只是第一步，react-native-mapa还需要持续完善和赋予新功能，我们诚挚邀请有意愿成为开源库核心开发的同学加入，可在留言区备注。

如何开发开源库

开发过程比较艰辛，第一次接触react native，环境准备遇到各种坑。要准备IOS、Android开发环境，大家都懂，即使合理上网，资源下载也是及不稳定，慢！但最终还是啃下来。

IOS环境需要使用HomeBrew安装，Watchman、XCode和CocoaPods，HomeBrew可以使用国内资源安装，安装完成后可以设置国内镜像安装提速。

XCode需要根据React native、IOS系统版本确定可使用版本，xcode提供了不同型号Iphone模拟器。

Android环境需准备JDK和Android Studio。

一个易用的开源库需要为用户提供完整的文档和Demo，如何实现？多看看同语言优秀的开源库是如何提供的。TypeScript可结合TypeDoc提供html或者md形式的API文档。

TypeDoc基于开发的TS类型自动生成API文档，当有多层类型引用时(例如A类型引用B类型、B引用C类型)，需要跳转到此才能查看到完整的类型定义，但一般查看API文档都希望在一层显示完整的类型定义，最终我们借助TypeDoc生成的结果，然后扁平化创建MD文档。

除了文档，提供完整的Demo也是开源库不可或缺的一部分。在项目下新建examples目录，并初始化react native应用。每新开发一个地图组件都需要在examples目录下补充对应的demo。

Demo展示

POI搜索

数据展示

三维模型

查看更多demo： github.com/cnmapos/rea…

写在最后，如果大家有疑问可直接留言，一起探讨!感兴趣的可以点一波关注。