如何在iOS项目中编译并集成开源C库VLFeat？

我之前也踩过VLFeat官网旧指南的坑，特意整理了一套适配最新iOS环境（针对arm64架构）的步骤，亲测有效：

一、准备工作 #

• 安装Xcode Command Line Tools：打开终端执行xcode-select --install，按照提示完成安装。
• 克隆VLFeat最新源码：终端里执行git clone https://github.com/vlfeat/vlfeat.git，进入源码目录cd vlfeat。

二、修改编译配置（适配iOS arm64） #

VLFeat默认的Makefile是针对桌面系统的，需要调整为iOS编译参数：

1. 打开源码根目录下的Makefile，找到CC和CFLAGS相关的配置，替换成以下内容：

   CC = clang
   CFLAGS = -arch arm64 -isysroot $(SDKROOT) -miphoneos-version-min=12.0 -O3 -Wall -Wextra -Wno-unused-parameter -Wno-sign-compare -Wno-missing-field-initializers
   

   （-miphoneos-version-min可以根据你的项目最低支持版本调整，比如改成15.0）
2. 在终端设置iOS SDK路径：

   export SDKROOT=$(xcrun --sdk iphoneos --show-sdk-path)
   

三、编译arm64静态库 #

1. 先清理之前的编译产物（如果有的话）：

   make clean
   

2. 开始编译：

   make
   

   编译完成后，在vlfeat/bin目录下会生成libvl.a（这就是我们需要的arm64静态库）。

四、集成到iOS项目 #

1. 把编译好的libvl.a和源码根目录下的vl文件夹（所有头文件）拖到你的iOS项目中（拖的时候记得勾选"Copy items if needed"）。
2. 配置Xcode项目：
   • 打开项目的Build Settings，找到Header Search Paths，添加头文件所在的路径（比如你把vl文件夹放在项目根目录，就填$(SRCROOT)/vl，记得设为recursive）。
   • 找到Other Linker Flags，添加-ObjC（虽然VLFeat是纯C库，但有时候会出现链接问题，加这个可以避免）。
   • 确认Valid Architectures里包含arm64（最新Xcode默认已经开启，不需要额外设置）。

五、验证集成是否成功 #

在你的iOS项目里写一段测试代码，比如在ViewController的viewDidLoad里调用VLFeat的版本函数：

#import <Foundation/Foundation.h>
#import "vl/vl.h"

- (void)viewDidLoad {
    [super viewDidLoad];
    const char* version = vl_version();
    NSLog(@"VLFeat version: %s", version);
}

运行项目到arm64架构的iPhone真机，如果控制台能打印出VLFeat的版本号，说明集成成功了。

常见问题处理 #

• 如果编译时出现"unknown architecture"错误：检查Makefile里的-arch arm64是否正确，或者确认SDK路径是否设置成功。
• 如果链接时出现"undefined symbol"错误：用lipo -info libvl.a确认静态库是arm64架构的，同时检查Other Linker Flags是否添加了-ObjC。

内容的提问来源于stack exchange，提问作者crazyshark