iOS地图SDK

注意：地图SDK6.5.1版本增加隐私合规接口，设置用户是否同意地图SDK隐私政策，默认不同意，设置为同意时才能创建BMKSearchBase及其子类对象，否则返回nil，将影响地图SDK所有检索组件功能的使用，地图展示及覆盖物能力不受影响。Xcode15编译问题，需要在 Build Settings -> Other Linker Flags，添加配置 -ld_classic（-ld_64即将被废弃)。

CocoaPods（如已安装请跳过第一步）

1. 设置 ruby 的软件源

由于默认的 ruby 的软件源(https://rubygems.org/)被墙阻拦导致CocoaPods安装失败，因此需要更新一下 ruby 的源。依次执行如下命令：


gem sources -l # (查看当前ruby的源)
gem sources --remove https://rubygems.org/ # (移除当前ruby的源)
gem sources -a https://gems.ruby-china.com
gem sources -l # (再次查看当前ruby的源)
# 显示如下文字表示更新成功。
# *** CURRENT SOURCES ***
# https://gems.ruby-china.com

2. 升级gem

gem 版本较低也可能导致安装或者升级失败，所以需要升级 gem。使用以下命令：


sudo gem update --system

3. 安装 CocoaPods

检查一下您的 OS X 的版本，若您的 OS X 版本小于等于 10.11，执行下面的命令安装 CocoaPods：


sudo gem install cocoapods

大于 10.11，使用如下命令安装：


sudo gem install -n /usr/local/bin cocoapods
 pod setup

注意：安装过程可能会耗时比较长，也有可能受网络状况影响造成失败，需要多次尝试直到成功。

使用CocoaPods 安装 SDK

在您项目工程（.xcodeproj）文件同目录下创建一个名为 Podfile 文件。如果您尚未创建 Xcode 项目，请立即创建一个并将其保存到您的本地计算机。

1. 创建并编辑Podfile内容：

打开terminal终端，cd到项目工程（.xcodeproj）文件同目录下，执行命令：


vim Podfile

进入Podfile后输入i编辑状态，iOS 基础地图SDK 的 Pod 库的名称为 BaiduMapKit，编辑Podfile的内容后保存退出，内容如下：


# 自6.0.0起基础地图支持分包集成
platform :ios, '10.0' #手机的系统
target 'YourProjectTarget' 
do #工程名字
    pod 'BaiduMapKit', '6.6.3' # 默认集成全量包
    # 可选组件
    # pod 'BaiduMapKit/Map', '6.6.3'    # 集成地图Map包
    # pod 'BaiduMapKit/Search', '6.6.3' # 集成地图Search包
    # pod 'BaiduMapKit/Utils', '6.6.3'  # 集成地图Utils包
end

进入Podfile后输入i编辑状态，iOS 步骑行地图(已包含基础地图)SDK 的 Pod 库的名称为 BaiduWalkNaviKit，编辑Podfile的内容后保存退出，内容如下：


# 自6.0.0起步骑行地图支持分包集成
platform :ios, '10.0' #手机的系统
target 'YourProjectTarget' 
do #工程名字
    pod 'BaiduWalkNaviKit', '6.6.3' # 默认集成Base Map WalkNavi 组件
    # 可选组件
    # pod 'BaiduWalkNaviKit/Map', '6.6.3'      # 集成地图Map包
    # pod 'BaiduWalkNaviKit/WalkNavi', '6.6.3' # 集成地图WalkNavi包
    # pod 'BaiduWalkNaviKit/Search', '6.6.3'   # 集成地图Search包
    # pod 'BaiduWalkNaviKit/Utils', '6.6.3'    # 集成地图Utils包
end

进入Podfile后输入i编辑状态，iOS 导航+步骑行地图SDK (已包含基础地图)的 Pod 库的名称为 BaiduNaviKit-All，编辑Podfile的内容后保存退出，内容如下：


# 自6.0.0起导航+步骑行地图支持分包集成
platform :ios, '10.0' #手机的系统
target 'YourProjectTarget' 
do #工程名字
    # BaiduNaviKit-All pod版本号与基础地图版本号一致
    pod 'BaiduNaviKit-All', '6.6.3' # 默认集成Base Map Navi WalkNavi组件
    # 可选组件
    # pod 'BaiduNaviKit-All/Map', '6.6.3'      # 集成地图Map包
    # pod 'BaiduNaviKit-All/Navi', '6.6.3'    # 集成Navi包
    # pod 'BaiduNaviKit-All/WalkNavi', '6.6.3' # 集成WalkNavi包
    # pod 'BaiduNaviKit-All/TTS', '6.6.3''  # 集成TTS包
    # pod 'BaiduNaviKit-All/Search', '6.6.3''   # 集成地图Search包
    # pod 'BaiduNaviKit-All/Utils', '6.6.3'    # 集成地图Utils包
end

2. 执行安装命令


pod install

成功以后，会出现如下记录：

3. 导入成功，启动工程

命令执行成功后，会生成 .xcworkspace 文件，恭喜你已成功导入百度地图iOS SDK。打开.xcworkspace 文件以启动工程（注意：此时不能同时开启.xcodeproj文件），如下图所示。

注意：此种方式只支持导入全量包的SDK，包含百度地图iOS SDK所有功能。

CocoaPods相关问题

无法更新到最新版本

若已经安装了百度iOS地图SDK，想要更新到最新版本，在Podfile文件的目录下使用以下命令：


pod repo update #用于保证本地地图相关SDK为最新版 pod update

pod search无法搜索到类库的解决办法（找不到类库）

（1）执行 pod setup

（2）执行 rm ~/Library/Caches/CocoaPods/search_index.json

（3）执行pod search pod setup成功后会生成

~/Library/Caches/CocoaPods/search_index.json文件。

删除~/Library/Caches/CocoaPods目录下的search_index.json文件

删除成功后再执行pod search

注册和获取密钥

Objective-C 环境配置

本篇文章对您是否有帮助？