本程序示范了如何用Swift调用自定义C语言模块的方法。您可以直接在github下载本程序,或者按照以下教程逐步完成。
简介
示范程序中有一个C语言的源程序CSwift.C和一个头文件CSwift.h,我们的目标是构造一个CSwift的函数库,能够让swift源程序执行CSwift程序中的函数。
快速上手
本程序需要Swift 3.0以上版本。
下载、编译和测试
$ git clone https://github.com/RockfordWei/CSwift.git $ cd CSwift $ swift build $ swift test
源程序采用C语言写成,测试程序则是Swift语言编写。因此如果通过测试,则恭喜您,已经成功实现了Swift语言调用C语言的整个过程。
详细步骤
您可以完全不依赖所有上述内容,而一步一步从零开始制作C函数库和调用C库的Swift代码:
构造空白的函数库
仍然假定函数库名称为CSwift。首先找一个空白目录,然后执行:
$ mkdir CSwift $ cd CSwift $ swift package init --type=system-module $ mkdir CSwift $ cd CSwift $ swift package init $ mv Tests .. $ mkdir include $ mv ../module.modulemap inlcude/ $ rm Package.swift $ rm -rf Sources $ echo > CSwift.c $ echo > include/CSwift.h $ cd ..
细心的读者会发现,上面的bash 命令行在CSwift 文件夹下面建立了第二个CSwift文件夹,但是使用了不同的swift package
了命令。第一个命令是“创建swift空白项目,而且项目类型是系统模块”;而第二个命令是“创建swift 空白项目,项目类型是函数库”。这种做法主要是为了能够在同一个项目中用Swift去测试C语言的模块。其次,在第二个CSwift 子目录下,还建立了一个include 文件夹,并分别建立了两个空白源程序文件 CSwift.c 和 CSwift.h
Module Map
下一步是修理一下目标的模块映射表。请把module.modulemap修改为如下程序:
module CSwift [system] { header "CSwift.h" link "CSwift" export * }
C模块编程
好了,现在请在Source文件夹下面建立两个C语言文件:CSwift.c和CSwift.h,内容如下:
CSwift/CSwift/include/CSwift.h
extern int c_add(int,int); #define C_TEN 10
CSwift/CSwift/CSwift.c
#include "include/CSwift.h" int c_add(int a,int b) { return a + b ; }
到此为止,C语言函数库就应该准备好了。
Swift 程序调用
请修改Tests/CSwiftTests/CSwiftTests.swift文件,内容如下:
import XCTest@testable import CSwift class CSwiftTests: XCTestCase { func testExample() { // 测试调用 C 函数 let three = c_add(1,2) XCTAssertEqual(three,3) // 测试调用 C 语言的符号 XCTAssertEqual(C_TEN,10) } static var allTests : [(String,(CSwiftTests) -> () throws -> Void)] { return [ ("testExample",testExample),] } }
测试
最后一步最简单,直接执行:
$ swift build $ swift test
如果没有问题,那就一切OK了!
其他
如果您在使用Xcode,则需要使用swift package generate-xcodeproj,但是需要调整上述build.lib.sh内容的编译目标目录,并配合Xcode偏好设置选择匹配的目录,否则无法测试。
长按二维码关注Perfect 官网
微信号:PerfectlySoft (公司名)
如果需要帮助,请注册我们在Slack上的中文频道: http://perfect.ly/