本文及后续系列文章主要采用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同级目录下。
源代码地址
https://github.com/icgp/STKComponentsTutorial/tree/master/Example001
