本文及后續(xù)系列文章主要采用STK組件的.Net版本作為開發(fā)包憎亚。
1. 獲取開發(fā)包
正常的獲取途徑是訪問AGI官網(wǎng)，注冊并登錄后桌肴，從官網(wǎng)下載開發(fā)包：https://support.agi.com/downloads/，如果是首次下載航唆，AGI會向你注冊的郵箱地址發(fā)送有效期半年的使用授權許可文件（lic文件）将谊。
但是由于某種原因國內(nèi)的IP無法訪問該網(wǎng)站冷溶，也無法注冊成功渐白。
2. 開發(fā)包組成
下載后的開發(fā)包是一個壓縮的zip文件，無需安裝逞频，直接解壓即可礼预。
以2019r2版為例，包名：STKComponentsForDotNet2019r2.zip虏劲，里面包含3個文件和3個文件夾：
- 文件夾
Assemblies：里面包含所有的dll文件和xml文件 - 文件夾
Documentation：只包含一個STK Components.chm幫助文件 - 文件夾
Examples：包含11個示例代碼和數(shù)據(jù) - 文件
GdalData.zip：Gdal圖像處理需要用到的數(shù)據(jù) - 文件
STK Components License Agreement.pdf：許可協(xié)議 - 文件
vc_redist.x64.exe：vc2017運行時
3. 系統(tǒng)要求
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. 在控制臺程序中使用開發(fā)包
開發(fā)前需要將lic文件復制到
AGI.Foundation.Core.dll同級目錄下
- 新建項目：使用Visual Studio 2019（也可是低一點版本的VS）新建一個C#的控制臺程序应结，名稱為Example001，框架選.NET Framework 4.6
-
添加
licenses.licx：在解決方案管理器中泉唁，鼠標右鍵點擊本項目鹅龄，在彈出菜單中選擇添加->現(xiàn)有項...，添加licenses.licx文件至項目亭畜，此文件在開發(fā)包的Assemblies目錄下扮休。右擊新添加的這項，選擇屬性項拴鸵，確保licenses.licx文件的生成操作的值是嵌入的資源
licenses.licx文件不是lic文件玷坠，此文件的作用是告訴編譯器lic文件驗證算法是在哪個模塊哪個類中
-
添加程序集引用：在項目中添加對
AGI.Foundation.Core.dll和AGI.Foundation.Models.dll的引用，文件在開發(fā)包的Assemblies目錄中劲藐。 -
添加代碼：先將
Program.cs文件重命名為Example001.cs八堡，然后在文件代碼修改成下面的代碼，代碼的作用是顯示當前開發(fā)包的版本號聘芜、計算當前時間地球質(zhì)心和月球質(zhì)心之間的距離：
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);
// 計算當前時刻地球質(zhì)心和月球質(zhì)心之間的距離
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();
}
}
}
項目的文件結構如下圖所示
完成后項目的文件結構
- 編譯代碼： 生成并執(zhí)行代碼，如果正常汰现，會在控制臺輸出類似如下結果：
DisplayVersion: 2019 r2
Version: 19.2.399.0
當前時間：2019-05-13 20:55:27.466挂谍，當前日月距離：368820.234千米
如果出現(xiàn)
lc.exe”已退出，代碼為 -1這樣的錯誤服鹅，表明lic文件無效或者沒有放到AGI.Foundation.Core.dll同級目錄下凳兵。
源代碼地址
https://github.com/icgp/STKComponentsTutorial/tree/master/Example001
