STK组件基础篇：开发入门

本文及后续系列文章主要采用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同级目录下

1. 新建项目：使用Visual Studio 2019（也可是低一点版本的VS）新建一个C#的控制台程序，名称为Example001，框架选.NET Framework 4.6
2. 添加licenses.licx：在解决方案管理器中，鼠标右键点击本项目，在弹出菜单中选择添加->现有项...，添加licenses.licx文件至项目，此文件在开发包的Assemblies目录下。右击新添加的这项，选择属性项，确保licenses.licx文件的生成操作的值是嵌入的资源

licenses.licx文件不是lic文件，此文件的作用是告诉编译器lic文件验证算法是在哪个模块哪个类中

3. 添加程序集引用：在项目中添加对AGI.Foundation.Core.dll和AGI.Foundation.Models.dll的引用，文件在开发包的Assemblies目录中。
4. 添加代码：先将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();
        }
    }
}

项目的文件结构如下图所示

完成后项目的文件结构

5. 编译代码： 生成并执行代码，如果正常，会在控制台输出类似如下结果：

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