iRIC インストーラ作成用リポジトリへの登録¶
はじめに¶
iRIC は、インストーラの作成及びオンラインアップデートのために公開するファイルの管理を、 github というウェブサービスを利用して行っています。
ソルバ開発者は、 github に最新のソルバのファイルを登録することで、以下を行なうことが できます。
- 次回インストーラが作成される際に同梱されるソルバを更新します
- 既に iRIC をインストールしているユーザが、 オプション -> メンテナンス 機能から、 ソルバの更新版をオンラインアップデートで入手するできるようにします
この節では、ソルバ開発者が github に最新のソルバを登録する手順を説明します。
作業の流れ¶
github に最新のソルバを登録するには、以下の流れで作業を行います。
- Subversion のクライアントのインストール (初回のみ)
- サーバからのフォルダの取得 (チェックアウト)
- 新しいファイルのコピー
- 新しいファイルのサーバへの登録 (コミット)
github へのファイルの登録は、 Subversion と git の2つのバージョン管理システム を使って行なうことができますが、ここでは操作の簡単な Subversion を 利用した場合の手順をご説明します。
以下で、詳しい手順を説明します。
Subversion のクライアントのインストール (初回のみ)¶
インストール¶
Subversion に関連した操作を行うためのクライアントをインストールします。 この手順では、Windows 用の Subversion クライアントである TortoiseSVN をインストールします。
以下の URL にアクセスし、 TortoiseSVN のインストーラを入手します。
https://tortoisesvn.net/downloads.html
画面上には、 32bit版 OS用と 64bit版 OS用の2つのダウンロード用ボタンがあります。お使いの環境 に合わせて適切なインストーラをダウンロードして下さい。
日本語でお使いになりたい場合は、画面の少し下にある Language packs を追加でインストールすること で、メニューが日本語になります。"Japanese" という行の "Setup" リンクをクリックして ダウンロードしてください。
インストーラがダウンロードできたら、まずは TortoiseSVN 本体、その後 Language pack の順番で インストールして下さい。
インストールが完了したら、一度 Windows を再起動します。
サーバからのフォルダの取得 (チェックアウト)¶
https://github.com/i-RIC/online_update.git/trunk/dev_src/packages 以下のフォルダのうち、更新したいソルバが含まれているフォルダをチェックアウトします。
例えば、 FaSTMECH なら以下のフォルダをチェックアウトします。
https://github.com/i-RIC/online_update.git/trunk/dev_src/packages/solver.fastmech
以下では、 FaSTMECH のフォルダを取得する際の例を示します。
サーバからのフォルダの取得¶
TortoiseSVN を利用して、サーバからフォルダを取得します。
上記で作成したフォルダをエクスプローラで選択し、右クリックメニューから以下を選択します。
SVN チェックアウト
すると、 図 67 に示すダイアログが表示されます。
「リポジトリのURL」欄に、以下の URL を入力します。
https://github.com/i-RIC/online_update.git/trunk/dev_src/packages
その後、その右にある「...」ボタンを押します。すると、 図 68 に示すダイアログが表示されます。
このダイアログで、自分が更新したいソルバが含まれているフォルダ (今回の例なら "solver.fastmech") を選択し、「OK」ボタンを押します。 すると、「リポジトリのURL」 が更新されます。
図 67 に示すダイアログで、 「リポジトリのURL」「チェックアウト先のディレクトリ」が正しく設定されている ことを確認したら、「OK」ボタンを押します。すると、 図 69 に示すようなダイアログが 表示され、フォルダ内のファイルの取得が始まります。
ファイルの取得が完了すると、エクスプローラでは 図 70 に示すように表示されます。 チェックアウトされたファイルの横には、チェックマークのついたアイコンが表示されます。
新しいファイルのコピー¶
チェックアウトしたフォルダに、インストーラに同梱したいファイルをコピーします。 ファイルをコピーすると、ファイルの横のアイコンが以下のようになります。
- 上書きされたファイルの横には、「!」マークのついたアイコンが表示されます
- 新しくコピーされたファイルの横には、アイコンにマークが表示されません
新しくコピーされたファイルをサーバに送信するには、ファイルを右クリックして、 右クリックメニューから以下を選択します。
TortoiseSVN --> 追加
追加を行うと、ファイルの横に「+」マークが表示されます。
"Fastmech.exe" を上書きし、 "newdll.dll" を追加した後のエクスプローラの表示例を 図 71 に示します。
ご注意
ソルバの更新をする時は、ソルバの実行ファイルなどを更新するだけでなく、 definition.xml に記述されたバージョン番号も更新してください。 これは、バージョン番号が変わっていないと、 iRIC メンテナンスが ファイルが更新されていることを認識できないためです。
バージョン番号は definition.xml の SolverDefinition 要素で、 version という 名前の属性で指定されています。