Eclipse KuraのOSGiベースのIoT Gatewayのためのフレームワークです。アプリはjarファイルにマニフェストやリソースファイルを追加してパッケージングしたOSGiバンドルをデプロイして使います。今回はEclipuse Kuraのアプリのプログラミング環境としてmacOS SierraにEclipse IDE for Java Developersをインストールして簡単な初期設定を行います。
Java 8
macOSのパッケージ管理ツールのHomebrewとHomebrew CaskからJava 8をインストールします。Oracleのダウンロードサイトから直接パッケージをダウンロードすることもできます。
まだHombrewを使ったことがない場合はインストールします。
$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
インストール済みの場合は、古いHombrewとパッケージを更新して最新の状態にします。
$ brew update && brew cleanup
Homebrew Caskをインストールします。
$ brew install caskroom/cask/brew-cask
versionsを追加してjavaを検索します。
$ brew tap caskroom/versions
$ brew search java
現在のjavaパッケージのバージョンは1.8.0_112です。
$ brew cask info java
java: 1.8.0_112-b16
https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
Not installed
Java8をインストールします。
$ brew cask install java
1.8.0_112のバージョンがインストールされました。
$ java -version
java version "1.8.0_112"
Java(TM) SE Runtime Environment (build 1.8.0_112-b16)
Java HotSpot(TM) 64-Bit Server VM (build 25.112-b16, mixed mode)
以下のコマンドを実行するとJAVA_HOMEの場所を確認できます。
$ /usr/libexec/java_home -v 1.8
/Library/Java/JavaVirtualMachines/jdk1.8.0_112.jdk/Contents/Home
~/.bashrcに環境変数のJAVA_HOMEを設定します。
$ echo 'export JAVA_HOME=`/usr/libexec/java_home -v 1.8`' >> ~/.bashrc
$ source ~/.bashrc
$ echo $JAVA_HOME
/Library/Java/JavaVirtualMachines/jdk1.8.0_112.jdk/Contents/Home
Maven
JavaアプリのビルドツールのMavenをインストールします。MavenやGradle、stbなどVMの開発ツールをインストールする場合はSDKMAN!が便利です。
SDKMAN!をインストールします。
$ curl -s get.sdkman.io | /bin/bash
sdkコマンドからMavenをインストールします。
$ sdk install maven
3.3.9のバージョンがインストールされました。
$ mvn --version
Apache Maven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-11T01:41:47+09:00)
Eclipse Neon.2 (4.6.2)
macOS用のインストーラーをダウンロードサイトから取得します。
eclipse-inst-mac64.tar.gzファイルから解凍したEclipse Installerを実行します。以下のディレクトリのEclipseを起動します。
~/eclipse/java-neon/Eclipse
初期設定
複数人で開発する場合はEclipseの設定を統一しておくとバージョン管理でdiffが正確に取れます。以下の私の好みなのでチームの規約に合わせて設定を確認してください。
ファイルのタブは空白にする
Eclipseの環境設定メニューからJavaのFormatterに新しいプロファイルの作成します。適当にEclise [myproject]としました。
Eclipse -> 環境設定 -> Java -> Code Style -> Formatter -> New -> Eclipse [myproject]
Indentationタブを以下の設定にします。
- Tab policy: Spaces only
- Indentation size: 4
- Tab size: 4
Mavenで使うpom.xmlなどXMファイルも同様に設定します。
Eclipse -> 環境設定 -> XML -> XML Files -> Editor
- Indent using spaces: チェック
- Indentation size: 2
ファイルの末尾は空白除去する
Java Code StyleにClean Upに新しいプロファイルの作成します。
Eclipse -> 環境設定 -> Java -> Code Style -> Clean Up -> New -> Eclipse [myproject]
- Remove trailing whitespace: チェック
既存のソースファイルから末尾の空白を除去する場合はこのClean UPを実行します。
src -> 右クリック -> Source -> Clean UP
ファイル保存時に末尾の空白を削除する場合はSave Actionsを使います。
Eclipse -> 環境設定 -> Java -> Editor -> Save Actions
- Perform the selected actions on save: チェック
Additional actionsの設定を変更します。
Additional actions -> Configure
- Remove trailing whitespace： チェック
- All lines: チェック
テーマ
Eclipseの外観をDarkテーマを変えたい場合は以下の設定をします。
Eclipse -> 環境設定 -> General -> Appearance
- Theme: Dark
プラグイン
EclipseのプラグインもOSGiバンドルとして配布されています。プラグインも好みですがとりあえず最初に必要なプラグインをいくつかインストールします。
EGit プラグイン
EGitプラグインはEclipseからGitを操作することができます。EGitのダウンロードサイトを追加します。
Help -> Install New Software... -> Add
- Name: EGit
- Location: http://download.eclipse.org/egit/updates
使いたいパッケージをチェックしてインストールします。
- Git integration for Eclipse
- Java implementation of Git
EclipseからSSH経由でGitリポジトリを使う場合は秘密鍵の設定を行います。
Eclipse -> 環境設定 -> General -> Network Connections -> SSH2
- SSH2 home: ホームディレクトリの
~/.sshなど - Private keys: GitHubに登録してある公開鍵とペアの秘密鍵など
Gitパースペクティブを開きます。
Window -> Persepective -> Open Persepective -> Other -> Git
M2Eclipse (m2e) プラグイン
M2EclipseはEclipseからMavenコマンドを実行することができます。プラグインはインストール済みですが、ダウンロードサイトを追加しておきます。
Help -> Install New Software... -> Add
- Name: m2e
- Location: http://download.eclipse.org/technology/m2e/releases
Maven SCM Handler for EGit
Maven SCM Handler for EGitはm2eから直接git cloneしてのpom.xmlの依存関係を解決してくれます。
パッケージエクスプローラーにプロジェクトをインポートするときのダイアログの中で、m2e Marketplaceからインストールします。
Package Explorer > Import > Maven > Check out Maven Projects from SCM > m2e Marketplace > m2e-egit
Eclipsをリスタートしてインストール終了です。
mToolkitプラグイン
これからEclipse Kura Documentationを読みながらEclipseで簡単なOSGiのアプリをビルドしていこうと思います。準備としてEclipse Kura上で動作するOSGiコンテナにリモートから接続できるmToolkitのプラグインをインストールします。BoschグループのProSystが提供しているOSGi管理ツールのmBS SDKに含まれています。
Help -> Install New Software... -> Add
- Name: mtoolkit
Location: http://mtoolkit-neon.s3-website-us-east-1.amazonaws.com
Group items by category: チェックを外す
mTooklit: チェック
Plug-in Development Environment (PDE) プラグイン
Plug-in Development Environment (PDE)はEclipseのプラグインを開発するためのツールです。OSGiプロジェクトの開発ではComponent Definition (component.xml)を作成するウィザードを利用します。
Help -> Install New Software...
type filter textフィールドにEclipse plug-inを入力して検索します。
- Work with: Neon - http://download.eclipse.org/releases/neon
- type filter text: Eclipse plug-in
- Eclipse Plug-in Development Environment: チェック
これでEclipse KuraのOSGiバンドル開発のためのEclipse Neon.2のセットアップは終了です。次回はサンプルプロジェクトをビルドして動かして見ようと思います。