1
1
# CommEx
2
- [ AtsEX] ( https://github.com/automatic9045/AtsEX ) AtsEXを通してBveと外部で通信するプラグイン
2
+ [ AtsEX] ( https://github.com/automatic9045/AtsEX ) を通してBveと外部で通信するプラグイン
3
3
4
4
5
5
## プラグインの機能
24
24
1 . ** AtsEX バージョン情報・プラグイン一覧** を開く
25
25
1 . ** CommEx** が有効になっていることを確認(デフォルトで有効)
26
26
27
- ## このテンプレートの機能
28
- - 取っ掛かりやすいように3種類のプラグインのファイル
29
- - マッププラグイン
30
- - 車両プラグイン
31
- - 拡張機能
32
- - Actionsでのdll自動生成
33
- - 頑張って書いた[ wiki] ( ../../wiki/ )
34
-
35
-
36
- ## 動作環境
37
- - [ AtsEX] ( https://github.com/automatic9045/AtsEX )
38
- - [ ver1.0-RC8 - v1.0.40401.1] ( https://github.com/automatic9045/AtsEX/releases/tag/v1.0.40401.1 ) or later
39
- - Win10 22H2, Win11 22H2 or later
40
- - Visual Studio 2022
41
- - Microsoft Visual Studio Community 2022 (64 ビット) - Current Version 17.5.3
42
- - [ Bve] ( https://bvets.net/ )
43
- - BVE Trainsim Version 6.0.7554.619
44
-
45
-
46
- ## 依存環境
47
- - [ AtsEx.CoreExtensions] ( https://www.nuget.org/packages/AtsEx.CoreExtensions/ ) (1.0.0-rc7)
48
- - [ AtsEx.PluginHost] ( https://www.nuget.org/packages/AtsEx.PluginHost/ ) (1.0.0-rc8)
49
-
50
- 間接参照を含めたすべての依存情報については、各プロジェクトのフォルダにある ` packages.lock.json ` をご確認ください。
51
-
52
27
53
28
## 使い方
54
- 1 . Use this template から新しくリポジトリを作成する
55
- 1 . githubリポジトリの詳細を設定する
56
- 2 . LICENSEの著作権表記を変更する
57
- 1 . 自分の作りたい機能に合わせて設定する
58
- 1 . コードを書く
59
- 1 . リリースする
60
-
61
- ### 0. 下準備
62
- #### 0.1. テンプレートから新しくリポジトリを作成して設定する
63
- 1 . ` Use this template ` ボタンから新しいリポジトリの作成画面に入る
64
- - ` Create a new repository ` で新しくリポジトリを作成する
65
- - リポジトリの名前はお好みで
66
- - Description にプラグインの概要とかを書いておくといい
67
- 1 . リポジトリの設定画面でDescriptionやTopicsを設定する
68
- 1 . LICENSEの著作権表記を変更する
69
- 1 . README.md を消した後 README_TEMPLATE.md を README.md にリネームしてtodoを埋める
70
-
71
- #### 0.2. ローカルにクローンする
72
- 1 . ` < > Code ` からURLをコピーする
73
- 1 . Visual Studio を開いて リポジトリのクローン からコピーしたURLでローカルにクローンする
74
-
75
- できないときとかは下のコマンドでできる
76
- ``` bash
77
- git clone https://github.com/USERNAME/REPONAME.git
78
- ```
79
-
80
- #### 0.3. Visual Studio でビルドできる状態にする
81
- 1 . AtsExCsTemplate.csproj を開いてすべて保存から適当な場所にslnを生成する
82
- 1 . NuGetからAtsEx関連のライブラリを入れる(ビルドすれば勝手に入る)
83
- 1 . 開発するプラグインの種類に応じて要らないファイルを削除する
84
- - MapPlugin/
85
- - マッププラグイン用のプロジェクト
86
- - VehiclePlugin/
87
- - 車両プラグイン用のプロジェクト
88
- - Extension/
89
- - 拡張機能用のプロジェクト
90
-
91
- #### 0.4. プラグイン情報の設定
92
- ** Properties/AssemblyInfo.cs**
93
- BveからAtsExのバージョン情報を見たときに表示される内容を設定できます
94
- AtsExのバージョン情報画面から見えるのはファイル名と下の3項目です
95
29
96
30
## ライセンス
97
31
- [ MIT] ( LICENSE )
@@ -104,8 +38,6 @@ AtsExのバージョン情報画面から見えるのはファイル名と下の
104
38
- 著作者は一切責任を負わない
105
39
- 本プラグインは無保証で提供される
106
40
107
- ### 1. コードを書く
108
- 頑張ってゴリゴリ書きましょう
109
41
110
42
## 動作環境
111
43
- Windows
@@ -117,9 +49,6 @@ AtsExのバージョン情報画面から見えるのはファイル名と下の
117
49
- [ AtsEX] ( https://github.com/automatic9045/AtsEX )
118
50
- [ ver1.0-RC9 - v1.0.40627.1] ( https://github.com/automatic9045/AtsEX/releases/tag/v1.0.40627.1 ) or later
119
51
120
- ### 3. 公開する
121
- 公開ができる状態になったらmainにpushしてtag打ってreleaseを作りましょう
122
- <!-- tagを打つとciが走って自動でreleaseが作られビルド生成物が添付されます -->
123
52
124
53
## 開発環境
125
54
- [ AtsEX] ( https://github.com/automatic9045/AtsEX )
@@ -131,40 +60,10 @@ AtsExのバージョン情報画面から見えるのはファイル名と下の
131
60
- BVE Trainsim Version 5.8.7554.391
132
61
- BVE Trainsim Version 6.0.7554.619
133
62
134
- ## デバッグについて
135
- ※この項目に書いてあることは環境によって差異があるかもしれないので適宜自分の環境に合わせて読み替えること
136
- ### 1. 生成物がAtsExから読めるようにする
137
- そのままの状態でビルドしてもデバッグできないのでBveからAtsEx経由でビルドしたプラグインが読み込めるようにする必要があります
138
- そのためには大きく次のA,Bで2通りのやり方があります
139
- おすすめはBのシンボリックリンク経由です
140
- シンボリックリンク経由だとpdbなどのごみがBve側のディレクトリに散らばったりしなくて嬉しいです
141
- #### 1.A. 生成物の出力パスをいじる
142
- 1 . メニューバー > プロジェクト > (プロジェクト名)のプロパティ を選択しプロジェクトのプロパティ画面を開く
143
- 1 . サイドバー > ビルド を選択しビルドの設定画面を開く
144
- 1 . 出力セクションの出力パスをプラグインの出力先に設定する
145
- 1 . 試しにビルドしてみて出力されるか確認する
146
- #### 1.B.シンボリックリンクを張る
147
- 1 . 生成物がない場合はビルドしてダミーのdllを生成する
148
- 1 . 出力ディレクトリ(binの下)にある生成物へのシンボリックリンクをプラグインの配置場所に配置する
149
- - winでシンボリックリンクを簡単に張るには[ Link Shell Extension] ( https://www.gigafree.net/system/explorer/hardlinkshellextension.html ) がおすすめ
150
- 1 . 試しにビルドしてみて更新されるか確認する
151
- ### 2. Visual Studioでデバッグする
152
- #### 2.1. デバッグの設定をする
153
- 1 . メニューバー > デバッグ > (プロジェクト名)のデバッグプロパティ を選択しプロジェクトのデバッグプロパティ画面を開く
154
- 1 . 開始動作を"外部プログラムの開始"を選択しBveのパスを設定する
155
- 1 . 必要があればコマンドライン引数にシナリオファイルのパスを設定する
156
- - ここでシナリオファイルのパスを設定したらそのシナリオが直接読み込まれる
157
- - 何も指定しなければ普通にシナリオ選択画面が立ち上がる
158
- #### 2.2.実際にデバッグする
159
- 1 . 適当にブレークとかを張る
160
- 1 . デバッグを始める
161
- - F5キー
162
- - メニューバーのデバッグとテストの下あたりの開始ボタン(緑の三角形)
163
- 1 . 張ったブレークで止まるか見てみる
164
63
165
64
## 依存環境
166
65
- AtsEx.CoreExtensions (1.0.0-rc9)
167
66
- AtsEx.PluginHost (1.0.0-rc9)
168
67
169
- (開発者向け)
68
+ ### 開発者向け
170
69
間接参照を含めたすべての依存情報については、各プロジェクトのフォルダにある ` packages.lock.json ` をご確認ください。
0 commit comments