STK组件基础篇：开发入门

2024-01-20 23:42| 来源: 网络整理| 查看: 265

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

【本文地址】

公司简介

联系我们