• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

使用CoApp创建NuGetC++静态库包

原作者: [db:作者] 来自: [db:来源] 收藏 邀请

NuGet是微软开发平台下的包管理软件,使用它你可以非常方便的将一些第三方的库、框架整合进自己的项目中,省去了不少麻烦的配置过程。但是从官方文档上来看,貌似NuGet对C++的支持不是很好,并且在现阶段推荐使用CoApp来简化包的构建。

1. 环境要求

  • NuGet 2.5 及以上(较新版本才加入了对C++包的支持)
  • Windows Vista及以上,PowerShell 3.0(CoApp使用PS来构建C++本地包)
  • CoApp(简化包的构建过程,安装详见官网)

2. 准备材料

  • 静态库及相应发布的头文件
  • 静态库符号数据库(即PDB文件)
  • 文档(可选)

3. 编写AutoPackage脚本

这个脚本是用来指导CoApp构建我们的静态库包的,一般使用.autopkg作为其扩展名。 该文件由多个节点(Node)组成,节点的写法相当于C++中的命名空间。

3.1 nuget节点

这是脚本的父节点,它包含所有用来生成NuGet包的子节点。

nuget{

}

3.2 nuspec子节点

该节点包含要创建包的元数据,我们在这里指定将要生成的包的描述信息,这些信息会被显示在NuGet官网中的包页面下。常用的主要有:

  1. ID
  2. 版本(version)
  3. 标题(title)
  4. 作者(authors)
  5. 所有者(owners)
  6. 许可文件地址(licenseUrl)
  7. 项目地址(projectUrl)
  8. 图标地址(iconUrl)
  9. 概要(summary)
  10. 描述(description)
  11. 标签(tags)

这个节点是nuget的子节点,元数据的具体写法如下(注意每一项元数据后面都要跟一个分号;):

nuspec
{
    id = EasyXPlus;
    version : 1.0.1;
    title: EasyXPlus;
    authors: [email protected];
    projectUrl: "https://github.com/lgxZJ/EasyXPlus";
    summary:A simple C++ graphic library for BEGINNERS under windows!;

    description: "A simple C++ graphic library for BEGINNERS under windows!";
    tags: { beta, native, c++ };
}

3.3 files子节点

files节点也是nuget的子节点,用来指定生成包所需要的文件。对于C++静态库来说,我们只需要在files节点中指定三种文件:

1.头文件include : { "headers\*" }; 我们指定相对目录headers下的所有文件为发布的头文件。

2.文档(可选):docs : { "doc\html\* }; 我们指定相对目录doc\html下的所有文件为文档。

3.库文件、PDB文件:对于这些文件我们需要指定目标平台、VS版本和开发模式:

[x86, v140, debug] {
	lib:        builds\vs2015\libeasy\Debug\libeasyd.lib;
    symbols:    builds\vs2015\libeasy\Debug\libeasy.pdb;
}
[x64, v140, release] {
	...
}

这个数据项格式不同于其他简单的项,不需要在末尾跟分号;

下面是一些VS版本号与对应工具集:

  • VS2015 ---- v140
  • VS2013 ---- v120
  • VS2012 ---- v110
  • VS2010 ---- v100

3.4 targets子节点

我们没有用到这个节点,因此简单的在Defines定义中加上一个值:

targets
{
    Defines += HAS_EASYXPLUS;
}

至此,我们的脚本就编写结束了,完整的文件见链接

4. VS2015发布支持

但是CoApp还没有正式的版本支持VS2015,因此我们采用了github上一个workaround,这个节点需要写在nuget节点之前

configurations {
	Toolset { 
    	key : "PlatformToolset"; 
    	choices: { v140 };  
    	// Explicitly Not including pivot variants:  "WindowsKernelModeDriver8.0", "WindowsApplicationForDrivers8.0", "WindowsUserModeDriver8.0" 

    	// We're normalizing out the concept of the v140 platform -- Overloading the $(PlatformToolset) variable for additional pivots was a dumb idea.
    	v140.condition = "( $(PlatformToolset.ToLower().IndexOf('v140')) > -1 Or '$(PlatformToolset.ToLower())' == 'windowskernelmodedriver8.0' Or '$(PlatformToolset.ToLower())' == 'windowsapplicationfordrivers8.0' Or '$(PlatformToolset.ToLower())' == 'windowsusermodedriver8.0' )";
	};
}

5. 创建C++静态库包

在PowerShell下运行以下命令构建本地包,本地包默认在脚本所在目录下生成:

Write-NuGetPackage .\EasyXPlus.autopkg

如果运行时PowerShell提示无法加载模块或者无法加载文件,可以试着执行set-executionpolicy remotesigned


鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
上一篇:
C#-遍历datatable的几种方法发布时间:2022-07-13
下一篇:
C#下实现的半角转与全角的互转发布时间:2022-07-13
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap