Fengmap iOS SDK

配置工程 您可根据以下步骤创建一个基于Fengmap iOS SDK 能显示Fengmap数据的Xcode 工程。

Xcode工程配置方法

1. 引入头文件

首先将Fengmap iOS SDK提供的头文件和静态库文件拷贝到您的工程目录下,在Xcode中 引入SDK提供的头文件。

在您需要使用Fengmap iOS SDK的文件中添加以下头文件:

#import "FMMapKit.h"

2.引入静态库文件

Fengmap iOS SDK提供了模拟器和真机两种环境所使用的静态库文件,分别存放在libs/Release-iphonesimulator和libs/Release-iphoneos文件夹下。有三种方式可以引入静态库文件:

第一种方式:直接将对应平台的.a文件拖拽至Xcode工程左侧的Groups&Files中,缺点是每次在真机和模拟器编译时都需要重新添加.a文件;

第二种方式:使用lipo命令将设备和模拟器的.a合并成一个通用的.a文件,将合并后的通用.a文件拖拽至工程中即可,具体操作如下:首先,打开终端,cd到libs文件夹中,然后使用如下命令: lipo -create Release-iphoneos/libFMMapKit.a Release-iphonesimulator/libFMMapKit.a -output libFMMapKit.a,生成新的.a文件存放在libs文件夹中;

第三种方式:

  • • 将Fengmap iOS SDK的libs文件夹拷贝到您的Application工程根目录下;
  • • 设置静态库的链接路径,在Xcode的Project -> Edit Active Target -> Build -> Search Path -> Library Search Paths中添加您的静态库目录,比如"$(SRCROOT)/../libs/Release-$( PLATFORM_NAME)",$(SRCROOT)宏代表您的工程文件目录,$( PLATFORM_NAME)宏代表当前配置是iOS Device还是Simulator。
    注: 静态库中采用Objective-C和C++混合实现,因此需要您保证您工程中至少有一个.mm后缀的源文件(您可以将任意一个.m后缀的文件改名为.mm);

3.引入系统库:

Fengmap iOS SDK使用OpenGL渲染,因此您需要在您的Xcode工程中引入libz.1.tbd、CoreGraphics.framework、OpenGLES.framework、GLKit.framework。 添加方式:在Xcode的Project -> Active Target ->Build Phases ->Link Binary With Libraries,添加即可。

4. TARGETS-Build Settings设置:
在TARGETS-Build Settings-Other Linker Flags中添加如下内容:-ObjC; 注意O和C大写;

5. 引入FMBundle.bundle资源文件

FMBundle.bundle中存储了公共设施、定位、指北针及水印等资源图片,还存储了地图的默认主题文件。注意:加载地图会默认设置一套蜂鸟自定义主题,该主题文件不可以删除,否则会导致程序崩溃,如需要添加新的主题,请访问蜂鸟SDK官方网站查看主题的获取方式,在程序中更改您的主题。您也可以根据具体需求任意替换该bundle中Resources文件夹的图片文件。 添加方式:将FMBundle.bundle拷贝到您的工程目录,直接将该bundle文件拖拽至Xcode工程左侧的Groups&Files中即 可。若您需要替换定位、指北针的图标,公司水印请保留原文件名称,否则不显示替换的新图片。