阿里巴巴旗下的 高德地图 ,继承了其支付宝文档一样的DogShit 风格:能说清楚的,模糊着说;很简单的,自己猜测;一般的描述,能乱说就乱说。看完其文档,TM整个人都不好了。所以在此提供一个防坑指南,希望对小伙伴们有用。
上几个高德地图 SDK 文档截图(这是一个给万千开发者看的文档,错误百出,语句不通,步骤模糊,描述不清,我CAO):
1:
吐槽:
1.什么叫:在项目目录中(.xcodeproj)打开一个终端
是用.xcodeproj 打开一个终端(根本没这个功能)?还是直接打开.xcodeproj并创建文件?还在用终端打开.xcodeproj,然后创建Podfile项目?
2.创建一个名为 Podfile文件
这TM通顺吗?应该是 “创建一个名为 Podfile 的文件”。就这样把“的”字给省略了呀!语文老师死得早系列。。
2:
吐槽:小编你给我出来,什么叫2D和3D不能同时使用用,你是结巴吗?
3:下边这个有点啰嗦,重复。
这两个步骤 意在说明:pod install 是安装;pod repo update 是更新;pod install --repo-update 是安装并更新。
----------------------------------------------吐槽完毕,下为笔记----------------------------------------------------
第一步:导入SDK
1:百度或其他搜索网站搜索: 高德地图开发者, 进入 高德地图开发者 网站,输入你的账号密码,进入。没有的话,注册一个,然后申请个人或公司开发者,成功后,点击右上角 “控制台”,创建一个应用。
2:打开电脑终端,按照文档提示 安装CocoaPods。打开终端 输入代码:
$ sudo gem install cocoapods
然后点击回车 就行了,你的电脑安没安装cocoapods都操作一下吧,有备无患,稍等一下就OK了。
为啥要安装 cocoaPods?
3:创建Podfile 文件:(别按文档上瞎写的来,反正我没明白它的意思)
cd /Users/weishuai/Desktop/iOS/用心写文档
该文件夹下包含:用心写文档.xcodeproj、用心写文档UITests等等文件(看一下有没有
.xcworkspace文件,没有的话,步骤5会告诉你如何生成)。稍后生成的 Podfile 文件夹 也在该文件夹下。
3.2 在该文件夹路径下 终端输入:
pod init
pod init安装方法可以参考百度地图,如果出现“建立搜索提示”而不是SDK的各个版本号,可以等一下然后重启一个终端来搜索,搜索到的库如下图:
xcode会自动创建 Podfile 文件。然后 按路径找到该文件,双击打开。出现界面如下:
在末尾添加: pod '你的SDK'
结构如下:
即可。(2D或者 3D SDK 按需添加)
4: 终端 输入:$pod install --repo-update
$pod install --repo-update
安装并检查更新(文档上说的太啰嗦了,直接用这个就可以了)。网速不好的,且等着吧~~
如果出现如下问题:
Unable to add a source with url `https://github.com/CocoaPods/Specs.git` named `master`.
You can try adding it manually in `~/.cocoapods/repos` or via `pod repo add
成功后终端有类似界面:
5:什么,重启项目没有.xcworkspace文件,那是因为你没创建呗。。。
6:申请 iOS key。
未完待续...