本文及后续系列文章主要采用STK组件的.Net版本作为开发包。
1. 获取开发包
正常的获取途径是访问AGI官网,注册并登录后,从官网下载开发包:https://support.agi.com/downloads/,如果是首次下载,AGI会向你注册的邮箱地址发送有效期半年的使用授权许可文件(lic文件)。
但是由于某种原因国内的IP无法访问该网站,也无法注册成功。
2. 开发包组成
下载后的开发包是一个压缩的zip文件,无需安装,直接解压即可。
以2019r2版为例,包名:STKComponentsForDotNet2019r2.zip,里面包含3个文件和3个文件夹:
文件夹Assemblies:里面包含所有的dll文件和xml文件
文件夹Documentation:只包含一个STK Components.chm帮助文件
文件夹Examples:包含11个示例代码和数据
文件GdalData.zip:Gdal图像处理需要用到的数据
文件STK Components License Agreement.pdf:许可协议
文件vc_redist.x64.exe:vc2017运行时
3. 系统要求
STK Components For DotNet 2019r2版可在Windows和Linux平台上运行,除了Insight3D模块,其它模块均支持32位和64位。
Windows平台:需要.Net Framework4.5或更高版本,也可使用.Net Core2.0或更高版本
Linux平台:需要.Net Core2.0或更高版本,也可使用Mono
Insight3D模块只能在Windows平台上使用,且只支持64位
4. 在控制台程序中使用开发包
开发前需要将lic文件复制到AGI.Foundation.Core.dll同级目录下
新建项目:使用Visual Studio 2019(也可是低一点版本的VS)新建一个C#的控制台程序,名称为Example001,框架选.NET Framework 4.6
添加licenses.licx:在解决方案管理器中,鼠标右键点击本项目,在弹出菜单中选择添加->现有项...,添加licenses.licx文件至项目,此文件在开发包的Assemblies目录下。右击新添加的这项,选择属性项,确保licenses.licx文件的生成操作的值是嵌入的资源
licenses.licx文件不是lic文件,此文件的作用是告诉编译器lic文件验证算法是在哪个模块哪个类中
添加程序集引用:在项目中添加对AGI.Foundation.Core.dll和AGI.Foundation.Models.dll的引用,文件在开发包的Assemblies目录中。
添加代码:先将Program.cs文件重命名为Example001.cs,然后在文件代码修改成下面的代码,代码的作用是显示当前开发包的版本号、计算当前时间地球质心和月球质心之间的距离:
using AGI.Foundation;
using AGI.Foundation.Celestial;
using AGI.Foundation.Geometry;
using AGI.Foundation.Time;
using System;
namespace STKComponentsTutorials
{
class Example001
{
static void Main(string[] args)
{
// 显示版本号
Console.WriteLine("DisplayVersion: {0}", StkComponentsCore.DisplayVersion);
Console.WriteLine("Version: {0}", StkComponentsCore.Version);
// 计算当前时刻地球质心和月球质心之间的距离
DateTime now = DateTime.Now;
EarthCentralBody earth = CentralBodiesFacet.GetFromContext().Earth;
MoonCentralBody moon = CentralBodiesFacet.GetFromContext().Moon;
var vector = new VectorTrueDisplacement(earth.CenterOfMassPoint, moon.CenterOfMassPoint);
double distance = vector.GetEvaluator().Evaluate(new JulianDate(now)).Magnitude;
Console.WriteLine("当前时间:{0:yyyy-MM-dd HH:mm:ss.fff},当前日月距离:{1:0.000}千米",now, distance / 1000);
Console.Read();
}
}
}
项目的文件结构如下图所示
完成后项目的文件结构
编译代码: 生成并执行代码,如果正常,会在控制台输出类似如下结果:
DisplayVersion: 2019 r2
Version: 19.2.399.0
当前时间:2019-05-13 20:55:27.466,当前日月距离:368820.234千米
如果出现lc.exe”已退出,代码为 -1这样的错误,表明lic文件无效或者没有放到AGI.Foundation.Core.dll同级目录下。
源代码地址