Tag: 软件包

在Swift中包装C库(第1部分)

这篇文章是在Swift中包装C库的多部分指南中的第一篇。 第1部分将逐步完成构建Swift项目的过程,该项目可以使用Swift Package Manager(SPM)与C库libgraphqlparser进行交互。 其他部分将介绍如何将C接口包装为使用起来更自然的Swift API。 在探索特定库的示例时,此处描述的相同技术可以应用于大多数其他C库。 自2016年以来,在Shopify,我们一直在移动应用程序中使用GraphQL。GraphQL提供的优于典型REST API的优势之一是它具有定义明确的架构。 可以利用GraphQL模式编写代表各种查询和变异的网络响应的强类型Swift代码。 这段代码编写起来很繁琐且容易出错,因此我们决定构建一个可自动生成代表您的GraphQL查询和变异的Swift模型的工具。 构建这样的工具的首要挑战之一是找到一种方法来解析GraphQL语法中定义的查询和变异,并将其转换为可由Swift代码理解的抽象语法树。 构建语法分析器并非易事。 幸运的是,GraphQL组织已经发布了一个用C ++编写的开源解析器。 Swift无法直接与C ++代码互操作,但是libgraphqlparser项目提供了一个纯C API,只需做一点工作,就可以在Swift中使用它。 libgraphqlparser库的标头中定义了一些功能,可以完全满足我们的需求。 从libgraphqlparser的C头文件 第一个函数将采用GraphQL查询字符串,并将其转换为查询的AST表示形式。 对于本教程,我们将仅使用graphql_ast_to_json(ast)将AST转换为JSON并打印结果。 设置基本软件包 SPM要求定义一个包装系统库的Swift软件包,但是由于没有Swift代码,因此无法直接构建该软件包。 为了验证该库可以导入到Swift代码中,基本包必须将包装器包作为依赖项导入。 让我们构建该基本软件包。 $ mkdir GraphQLParser $ cd GraphQLParser GraphQLParser $ swift软件包init –type可执行文件 安装库 安装libgraphqlparser可以通过从源代码构建或使用以下命令通过自制程序来完成。 $ brew安装libgraphqlparser 完成初始项目设置后,我们需要将代码公开给Swift。 由于这是针对macOS命令行应用程序的,因此我们可以使用Swift Package Manager(SPM)。 为了向Swift代码公开系统库,我们需要告诉编译器在哪里可以找到我们要使用的代码。 通常,这包括将动态库的位置和任何必需的头文件的位置通知编译器。 在这种情况下,动态库可能已安装到/usr/local/lib/libgraphqlparser.dylib ,并且头文件将已写入/usr/local/include/graphqlparser 。 SPM通过要求用户定义一个包装系统库的程序包并为该库提供模块映射来解决此问题。 约定是在这些程序包之前使用大写的“ C”作为前缀,因此该程序包将被称为“ Clibgraphqlparser”。 在与GraphQLParser文件夹相邻的目录中初始化此软件包。 GraphQLParser […]