BridgePointのインストール手順（2019年10月以降、macOS）

> BridgePoint 7.5 以降では、ベースになっているEclipseの仕様の変更によって、CDTとC/C++パースペクティブを使うためには、JDK17以降が必要になりました。その状態ではBridgePointがCのビルド環境を見つけられなくなり、生成したCのコードをビルドできません。
BridgePointを起動後にC/C++パースペクティブに切り替えられない場合には、現在使用中のJDKのバージョンや環境変数JAVA_HOMEを確認してください。

# BridgePointを起動するとエラーになる

この記事は、macOSにおいてBridgePointをインストールして起動しようとしたら、次のようなエラーメッセージが出て起動しない場合について、その理由と対策を書いたものです。

> Windows環境については、同様の記事 [BridgePointのインストール手順（2019年10月以降、Windows10）](https://qiita.com/kuboaki/items/092253ed9fdcfbcb587f) を書いていますので、そちらを参照してください。

![200328-0011.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/b32a25d9-a75d-abef-6b05-64a0c5f12e78.png)

> An error has occurred.
> See the log file /Users/kuboaki/workspace_bp/.metadata/.log
>（パス名は私の環境におけるものです）

## 「BridgePoint.app は壊れているため開けません。ゴミ箱に入れる必要があります。」の場合

壊れていなくても、壊されたのと同じ状態になっていると、MacOSのGatekeeperが働いて警告を出してくれているからだそうです。

![sc_2021-02-20_10.30.12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/f497ab5d-8672-b572-2b28-6f46163547a5.png)

この場合については、次の記事を参照してください。

* [BridgePointのMac版は壊れている？](https://qiita.com/kuboaki/items/9dc2fe818df2acbe75e5)

# BridgePointについて

重複しますので、[BridgePointのインストール手順（2019年10月以降、Windows10）](https://qiita.com/kuboaki/items/092253ed9fdcfbcb587f) を参照してください。

# この記事の背景

重複しますので、こちらも、[BridgePointのインストール手順（2019年10月以降、Windows10）](https://qiita.com/kuboaki/items/092253ed9fdcfbcb587f) を参照してください。

# Javaランタイム環境のインストール

## 実行環境の選択

BridgePointはEclipse上の開発環境なので、Windows、Mac、Linux上で利用できます。

この記事では、macOS について説明します。macOS Catalina(macOS 10.15.4) で動作を確認しています。

## Javaランタイム環境を確認する

**BridgePointは Ver.7 になりました。BridgePoint Ver.7を使うには、Java 11が必要です**。
以下の説明は、BridgePoint Ver.6,　Java 8のときのものです。適宜読み替えてください。

> BridgePointにはJava 8が必要です。そこで、[AdoptOpenJDK](https://adoptopenjdk.net/index.html) のJava 8のJREを使います。
> 
> 今のところ、BridgePointは Java 11では動作しないようで、Java 11のJREを使って BridgePoint を実行しようとすると、起動時に「エラーが発生した」旨のメッセージを表示して起動できません。

MacやLinuxの場合、homebrewやaptがインストールするJREは（openjdkであっても）たいていJava 11以降になっているので、それとは別に BridgePint用に用意する必要があることに注意しましょう。

たとえば、私のJavaの環境では、次のように ver. 13 なっていますが、このJREではBridgePointは動作しません。

``` shell
$ which java
/usr/local/opt/openjdk/bin/java
$ java -version                           
openjdk version "13.0.2" 2020-01-14
OpenJDK Runtime Environment (build 13.0.2+8)
OpenJDK 64-Bit Server VM (build 13.0.2+8, mixed mode, sharing)
```

## Javaランタイム環境を取得する

[AdoptOpenJDK](https://adoptopenjdk.net/index.html) のWebサイトをブラウザで開くと、ビルド済みのOpenJDKをダウンロードするページが開きます。自分の選んだプラットフォームのページか確認し、違っていたら「Other platforms」から選び直します。

Version の中から、 OpenJDK 8 を選んでダウンロードします。
**BridgePointが Ver.7 の場合は、Java 11を選んでください**。

![200328-0012.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/d2f82b48-35da-fefb-a92a-79d23d962568.png)

この画面のリンクからは、pkg型式のファイルがダウンロードできます。

*  OpenJDK8U-jdk_x64_mac_hotspot_8u242b08.pkg
  * （バージョンは時期によって変わっているでしょう）

<img width="240" alt="200328-0013.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/c5ccbffc-5da4-a386-3298-230a4aa45a57.png">

## インストールを実行する

ダブルクリックして、指示に従ってインストールします。

![200328-0014.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/49b25df2-54bd-10ad-f242-4cc946766366.png)

![200328-0015.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/9decb8f8-9970-7dde-a233-73224a9f57df.png)

![200328-0016.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/3aa34497-6a74-0af4-1a97-73daa46acbde.png)

![200328-0017.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/dfc57a8f-def7-1528-e158-a9fee8ef7de6.png)

次へで表示される「カスタムセットアップ」の画面の下部で、デフォルトのインストール先のディレクトリが表示されていて、インストール先を確認・変更できるようになっています（基本的に変えない方がいいと思います）。

![200328-0018.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/6974bdfe-d972-17df-95ea-9440795f4e06.png)

![200328-0026.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/056f782f-97f3-4936-5994-242606437687.png)

もし、途中でユーザー名とパスワードを入力するダイアログが表示されたら、自分のユーザー名とパスワードを入力します。

![200328-0030.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/33f89944-8e70-4e47-579d-3edf9bd3fcb0.png)

インストール先ディレクトリを覚えておきましょう。あとでBridgePointのインストール後に設定の変更に使います。

インストールが完了したら、コマンドプロンプトからJavaの起動を確認しましょう。
インストールディレクトリの下の、 `Contents/Home/bin/java` が使いたいJavaコマンドです。

```shell
$ /Library/Java/JavaVirtualMachines/adoptopenjdk-8.jdk/Contents/Home/bin/java -version 
openjdk version "1.8.0_242"
OpenJDK Runtime Environment (AdoptOpenJDK)(build 1.8.0_242-b08)
OpenJDK 64-Bit Server VM (AdoptOpenJDK)(build 25.242-b08, mixed mode)
```


# BridgePointのインストール

## BridgePointを取得する

BridgePointを配布しているWebサイト[xtUML.org](https://xtuml.org/)をブラウザで開きます。

以前とWebサイトデザインが変わっていますが、Nightly Buildsからダウンロードするのは変わっていません。

![210211-0001.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/92b06c4d-673b-9e45-a23a-89e597909ae5.jpeg)

（以前のページ）
![GSW-20191029-053309.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/5e0fc3ee-8c96-42ef-560d-00716d9708b4.png)

ダウンロードページヘ移動します。
（この機会に、他のページも参照しておくのもよいでしょう）

![210211-0002.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/c3390013-3206-67b5-ec1c-37304686c249.jpeg)

（以前のページ）
![GSW-20191029-053656.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/3754c59c-9538-3dc9-d82a-ba78967afab2.png)

「Nightly Builds」の下端の「Downloads here」というリンクをクリックすると、最新ビルドの置いてあるAmazon S3のページが開きます。

![GSW-20191029-054158.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/86938b7b-4c5b-d7d1-3ff6-c7a168dc2dd7.png)

自分のインストール用アーカイブを選択して、ダウンロードします。
この記事では、「Mac 64-bit」を選びます。

## 配付アーカイブを展開する

ダウンロードできたら、zipファイルを展開すると、 `BridgePoint.app` が取り出せますので、希望の場所に配置します。

なお、展開の手順によっては、アーカイバがフォルダを作ってからその中に展開する場合があります。フォルダができていたら、そのときはフォルダの中身を確認しましょう。

この記事では、 `~/MyApplication` に置くことにしました。

``` shell
$ cd ~/MyApplication
$ ls -1
BridgePoint.app
```

## BridgePointの設定を修正する

> JREがインストールできている場合、まずはBridgePointを起動してみてください。JREを探してくれれば、以下の修正がなくても動作すると思います。起動したときに、まだこの記事の冒頭のエラーが発生するようなら、以下の修正を試みてください。

そのまま起動したのでは、この記事の冒頭のエラーが発生します。エラーを回避するために、BridgePoint.app の内包するディレクトリの中にある `bridgepoint.ini` を編集します。

この設定についてはGitHubの「[HOWTO Configure BridgePoint to use a Specific JRE](https://github.com/xtuml/bridgepoint/blob/master/doc-bridgepoint/process/HOWTO-configure-bp-jre.adoc) 」に説明したドキュメントがあります。詳しい説明が読みたい人や、ほかのプラットフォームでの設定を知りたい人は参照してください。

```shell
$ cd BridgePoint.app/Contents/Eclipse 
$ ls -1 
LICENSE
artifacts.xml
bridgepoint.ini  # これです
configuration
features
notice.html
p2
plugins
readme
tools
```
Finderで操作する場合には、 `BridgePont.app` で右クリックしてポップアップメニューから「パッケージの内容を表示」を使うと、内包するフォルダやファイルが参照できます。

`-vm` というオプション項目を追加して改行します。
そこにOpenJDKをインストールしたディレクトリの `bin` ディレクトリを書きます。そして、ディレクトリのなかにある `java.exe` をディレクトリの記述の末尾に追記します。オプションとパス名の間で改行しないと、設定が反映されないので、気をつけましょう。

**図はJava 8のときのものです。BridgePointが7.0以降のときは、Java 11以降を使ってください。**

![200328-0032.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/b186a2f0-ada3-b824-ab9f-136e0fc452f2.png)

**下記例は、Java 8のときのものです。BridgePointが7.0以降のときは、Java 11以降を使ってください。**

``` shell
-startup
../Eclipse/plugins/org.eclipse.equinox.launcher_1.4.0.v20161219-1356.jar
--launcher.library
../Eclipse/plugins/org.eclipse.equinox.launcher.cocoa.macosx.x86_64_1.1.551.v20171108-1834
-vm  # この行を追加して改行
/Library/Java/JavaVirtualMachines/adoptopenjdk-8.jdk/Contents/Home/bin/java  # 次の行にパス名を追加
-vmargs
（以下略）
```

## BridgePointを起動する

# BridgePointを起動する

BridgePointが起動できるか確認します。BridgePointをインストールしたディレクトリの `BridgePoint.app` アイコンをダブルクリックして起動してみましょう。


<img width="240" alt="200328-0008.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/71f0425f-5ea8-de0c-1197-acf8f4b008fb.png">

初めて起動したときには、次のような警告ダイアログが表示され、起動できません。ここで「ゴミ箱に入れる」をクリックしてはダメですよ。

![200328-0007.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/75fd6a16-da1d-90b5-1985-ab2983a90a0f.png)

このときは、 `BridgePoint.app` アイコンを右クリックして、ポップアップメニューを開きます。

<img width="240" alt="200328-0009.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/134e9b10-cb89-6db9-a183-52211b8d3f8f.png">

「開く」を選ぶと、次のような警告ダイアログが表示されます。

![200328-0010.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/452d405f-97cc-8b77-4696-17b228abb54b.png)

「開く」をクリックすると、BridgePointが起動します。
一度この手順を実施すれば、次回からは警告ダイアログなしに起動するようになります。

起動すると、スプラッシュ画面が表示されます。

![GSW-20191029-000357.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/3e94b84d-fbe9-07f6-3d5f-e84e360116e6.png)

そののち、Projectで使うワークスペースを選択するダイアログが表示されます。このワークスペースはEclipseを使う場合に設定するワークスペースと同じ考え方です。自分がBridgePointを使う場所を決めて、そのディレクトリを選択しましょう。

<img width="512" alt="200328-0037.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/386cc2c6-39ad-f780-1d8b-aa857b5bbd01.png">


起動できると、「Welcome to BridgePoint UML」という画面が表示されます。「Tutorial Video」を観たり、「Quick Start」を試してみましょう。


<img width="512" alt="200328-0038.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3221/74dabd91-e2cf-26a1-ca0a-979b5c489d62.png">


# 最後に

BridgePointを支えているOne Fact inc. 並びにユーザーコミュニティに感謝します。

BridgePointは、パワフルな開発手法である xtUML を支援する環境として長く培われてきた実績のある、大変優れたものです。ぜひ一度、BridgePointを使って xtUML を実践する機会を設けてみてください。