OLP CLI をインストールします
ここで HERE platform は、 OLP CLI のインストールおよび設定方法、およびサービスへのアクセスに使用する方法について説明します。
システム要件
次のオペレーティングシステムがサポートされています。
- Windows 10.
- Linux (Ubuntu 18.04)
- MacOS Sierra 以上
OLP CLI を使用するには、 Java ランタイム環境 (JRE) のバージョン 1.8.0_91 以降が必要です。
注
JRE バージョン
マシンにインストールされているバージョンを確認するに java -version
は、ターミナルウィンドウでコマンドを実行します。
Winget パッケージマネージャを使用します
winget
パッケージ管理者を使用すると、 Windows ユーザーは OLP CLI の検出、インストール、アップグレード、および削除を行うことができます。
OLP CLI が winget
パッケージ管理者とともにインストールされている場合 OpenJDK 17
、のイメージがパッケージ化され、コマンドの実行に使用されます。 別の JRE または JDK をインストールする必要はありません。
を使用して OLP CLI をインストールするには winget
、次のコマンドを実行します。
winget install HERE.OLPCLI
を使用して OLP CLI をアップグレードするには winget
、次のコマンドを実行します。
winget upgrade HERE.OLPCLI
を使用して OLP CLI を削除するには winget
、次のコマンドを実行します。
winget uninstall HERE.OLPCLI
注
実験的な機能
この機能は試験的なもので、既知のエラーと未検出のエラーの両方を含むことができます。
OLP CLI インストーラを使用します
Windows ユーザーには、インストーラが推奨されるソリューションです。
Windows インストーラを使用して OLP CLI をインストールするには、プラットフォーム ポータルから OLP CLI をダウンロードし、GUI を使用してインストールします。
インストーラが PATH
環境の設定を処理し、インストーラを再実行した場合は新しいバージョンについて通知します。
OLP CLI をアップグレードするには、管理者としてコマンドプロンプトを実行し、次のコマンドを実行します。
olp version update
OLP CLI を削除するには、次の手順に従います。
Start
を選択し、次にSettings
> Apps
> Apps & features
を選択します。 - を選択
OLP CLI
し、を押し Uninstall
ます。
apt パッケージマネージャを使用してください
apt
パッケージ管理者は、 Debian ベースのディストリビューションのユーザーが OLP CLI を発見、インストール、アップグレード、削除できるようにします。
OLP CLI が apt
パッケージ管理者とともにインストールされている場合 OpenJDK 17
、のイメージがパッケージ化され、コマンドの実行に使用されます。 別の JRE または JDK をインストールする必要はありません。
を使用して OLP CLI をインストールするには apt
、次のコマンドを実行します。
olp-cli
Debian パッケージが公開されている HERE platform Debian リポジトリを追加します
echo "deb https://repo.platform.here.com/artifactory/debian stable main" >> /etc/apt/sources.list
- HERE platform Debian リポジトリから GPG キーをインストールします
wget -qO- https://repo.platform.here.com/artifactory/api/gpg/key/public | apt-key add -
- パッケージ情報を更新し、 OLP CLI パッケージをインストールします
apt-get update
apt-get install olp-cli
注
必要なプロセッサアーキテクチャ
apt
パッケージマネージャーを使用した OLP CLI
のインストールには、プロセッサアーキテクチャ amd64
が必要です。
を使用して OLP CLI をアップグレードするには apt
、次のコマンドを実行します。
apt-get update
apt-get install olp-cli
を使用して OLP CLI を削除するには apt
、次のコマンドを実行します。
apt-get remove olp-cli
注
実験的な機能
この機能は試験的なもので、既知のエラーと未検出のエラーの両方を含むことができます。
HomeBrew を使用します
Homebrew は、 macOS と Linux のパッケージ管理者です。 次のようにして、 OLP CLI の最新バージョンをインストールできます。
brew install heremaps/olp-cli/olp
OLP CLI を更新する場合は、次のコマンドを実行します。
brew upgrade olp
パッケージを削除するには、次のコマンドを使用します。
brew uninstall olp
注
実験的機能
この機能は試験的なもので、既知のエラーと未検出のエラーの両方を含むことができます。
OLP CLI の ZIP アーカイブを使用します
ZIP アーカイブから OLP CLI をインストールするには 、 プラットフォーム ポータル から ZIP アーカイブをダウンロード し、次の手順に従います。
- アーカイブをフォルダに解凍します。
- Linux では、
olp
ファイルがあるフォルダへのフルパスをPATH
環境変数に追加し、 bash の起動時に実行される設定スクリプトと環境変数を含む隠しファイルである.bash_profile
ファイルにエクスポートします。 - Windows では、
olp.bat
ファイルが含まれているフォルダのフルパスをPATH
環境変数に追加します。
OLP CLI をアップグレードするには、管理者としてコマンドプロンプトを実行し、次のコマンドを実行します。
olp version update
OLP CLI を削除するには、次の手順に従います。
- 上記の手順で設定した PATH 環境変数から OLP CLI を削除します。
- CLI バイナリが含まれているフォルダを削除します。
OLP CLI を CI/CD 環境にインストールします
CI/CD 環境に OLP CLI をインストールするには 、次の方法で Maven を使用することをお勧めします。
-
リポジトリ資格情報をダウンロードして設定します。
-
OLP_TOOLS
OLP CLI をダウンロードする場所へのパスを含む環境変数を作成します。
OLP_TOOLS=user/olp_tools
mvn dependency:unpack -Dartifact=com.here.platform:cli_2.12:LATEST:zip -DoutputDirectory=\$OLP_TOOLS
set OLP_TOOLS=C:/user/olp_tools
mvn dependency:unpack -Dartifact=com.here.platform:cli_2.12:LATEST:zip -DoutputDirectory=%OLP_TOOLS%
9.3.9 バージョン以下の OLP CLI をインストールする場合は、次のコマンドを実行します。
OLP_TOOLS=user/olp_tools
mvn dependency:unpack -Dartifact=com.here.platform:cli:LATEST:zip -DoutputDirectory=\$OLP_TOOLS
set OLP_TOOLS=C:/user/olp_tools
mvn dependency:unpack -Dartifact=com.here.platform:cli:LATEST:zip -DoutputDirectory=%OLP_TOOLS%
-
OLP CLI が含まれているディレクトリを PATH
変数に追加します。
export PATH="$PATH:$OLP_TOOLS"
cd %OLP_TOOLS%
set PATH=%cd%;%PATH%
新しく更新された PATH
変数は、すべての子プロセスにのみ表示されます。
OLP CLI がインストールされました。 コマンド ラインからアクセスするには、次のように入力 olp [command]
します。
自動化スクリプトを使用して、 OLP CLI を CI/CD 環境に統合できます。 詳細について は、「スクリプト作成のヒント」を参照してください。
古いバージョンの OLP CLI をインストールします
OLP CLI の最新バージョンを使用して、最新の HERE platform 機能を最新の状態に保つことをお勧めします。 ただし、何らかの理由で OLP CLI の古いバージョンが必要な場合は 、以下 のように Maven を使用してダウンロードしてください。
- リポジトリ資格情報をダウンロードして設定します。
-
以下のコマンドを実行します。 OLP_CLI_VERSION
パラメータは 9.3.9 バージョンよりも大きい値にする必要があります。
OLP_CLI_DIR=<path/to/directory>
OLP_CLI_VERSION=<desired-cli-version>
mvn dependency:unpack -Dartifact=com.here.platform:cli_2.12:$OLP_CLI_VERSION:zip -DoutputDirectory=$OLP_CLI_DIR -Dmdep.overWriteReleases=true
set OLP_CLI_DIR=<path/to/directory>
set OLP_CLI_VERSION=<desired-cli-version>
mvn dependency:unpack -Dartifact=com.here.platform:cli_2.12:%OLP_CLI_VERSION%:zip -DoutputDirectory=%OLP_CLI_DIR% -Dmdep.overWriteReleases=true
9.3.9 バージョン以下の OLP CLI をインストールする場合は、次のコマンドを実行します。
OLP_CLI_DIR=<path/to/directory>
OLP_CLI_VERSION=<desired-cli-version>
mvn dependency:unpack -Dartifact=com.here.platform:cli:$OLP_CLI_VERSION:zip -DoutputDirectory=$OLP_CLI_DIR -Dmdep.overWriteReleases=true
set OLP_CLI_DIR=<path/to/directory>
set OLP_CLI_VERSION=<desired-cli-version>
mvn dependency:unpack -Dartifact=com.here.platform:cli:%OLP_CLI_VERSION%:zip -DoutputDirectory=%OLP_CLI_DIR% -Dmdep.overWriteReleases=true
リリースされた CLI バージョンのリストについて は、ドキュメントを参照してください。