Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

You should already have applied for and obtained a developer license (development.key), so place it in the SDK/conf folder.

...

サンプルアプリのビルド

ここでは例としてサンプルアプリをビルドする手順を実施します。

Building the sample app

Here we will go through the steps to build a sample app as an example.

Move to ${SDK_DIR}に移動します。.

Code Block
cd ${SDK_DIR}

Add new options specific to ContainerAdamApp in setup_env.sh.shでContainerAdamApp専用のオプションを新たに追加します。

Code Block
source setup_env.sh ambaCV5XCEX
Info

初回ビルド時は、インターネット上にある必要なDockerイメージのダウンロードが実施されます。

インターネットに接続していることをご確認ください。

...

During the first build, the necessary Docker images will be downloaded from the Internet. Please make sure you are connected to the Internet.

After that, the ext file is built with the following shell script:

Code Block
./ext_docker_build.sh [サンプルアプリのディレクトリsample app directory]

例えば、C版のFor example, to build the C version of skeleton_sample_appであれば下記のようにビルドします。(Python版も同様ですので省略します, do the following. (The Python version is similar, so I will omit the details.)

Code Block
./ext_docker_build.sh src/adamapp/skeleton_sample_app

ビルドが成功すると、サンプルアプリのディレクトリ内に以下の二つのファイルが生成されます。

...

If the build is successful, the following two files will be generated in the sample app directory.

  • [app name]_[バージョン名version name].ext

  • [アプリ名app name]_[バージョン名version name].zip

アプリ名およびバージョン名はdockerThe app name and version name are taken from the first image value found at the top of docker_compose.yamlの上から一番最初に見つかった imageの値から取得しています。例えば .yaml. For example, if image: “skeleton_sample_app:0.0.6” と記載してあれば、ファイル名はskeletonis written, the file name will be skeleton_sample_app_0.0.6.ext (zip)となります。.

動作確認

カメラにインストールします(例:下記画像の緑枠からインストール可能)。作成した.extファイルを選択してインストールしてください。
アプリ画面を開きます(下記画像の赤枠ボタン)。

...

下記画像のような、文字列が表示されていれば成功です。

...

外部ライブラリを用いたビルド手順

外部ライブラリを用いたサンプルアプリのビルド

外部ライブラリを用いたアプリを開発したい場合も、Dockerfileに記載することで利用することができます。

...

Operation check

Install it on your camera (for example, you can install it from the green frame in the image below). Select the .ext file you created and install it. Open the app screen (red frame button in the image below).

...

If the text is displayed as in the image below, the operation was successful.

...

Build procedure using external libraries

...

Building a sample app with external libraries

If you want to develop an app that uses external libraries, you can use them by including them in the Dockerfile.

In addition, OpenSSL (Ver 3) and curl/libcurl (Ver 7.81.0) はベースのDockerイメージに搭載されているのでそのままご使用いただけます。ここでは例としてjpegare included in the base Docker image, so you can use them as is.

Here we will go through the steps to build jpeg_app_for_CV5Xをビルドする手順を実施します。CV5X as an example.

Note

C版ではlibjpeg、Python版ではNumpyおよびOpenCVをビルドします。数時間ビルドに時間がかかる場合がありますので十分な余裕を持ってビルドください。また、十分な空き容量も確保しておいてください。
※具体的に必要な時間や空き容量は外部ライブラリに依存します。

The C version builds libjpeg, and the Python version builds Numpy and OpenCV. The build may take several hours, so please allow yourself plenty of time to complete. Also, please make sure you have enough free space.
*The specific time and free space required will depend on the external library.

Move to ${SDK_DIR}に移動します。.

Code Block
cd ${SDK_DIR}

Add new options specific to ContainerAdamApp in setup_env.sh.shでContainerAdamApp専用のオプションを新たに追加します。

Code Block
source setup_env.sh ambaCV5XCEX

その後、以下のシェルスクリプトでextファイルがビルドされます。(Python版も同様ですので省略しますAfter that, the ext file is built with the following shell script. (Python version is the same, so it is omitted.)

Code Block
./ext_docker_build.sh src/adamapp/jpeg_app_for_CV5X

ビルドが成功すると、サンプルアプリのディレクトリ内に以下の二つのファイルが生成されます。

...

If the build is successful, the following two files will be generated in the sample app directory.

  • [app name]_[バージョン名version name].ext

  • [アプリ名app name]_[バージョン名version name].zip

動作確認

カメラにインストールします(例:下記画像の緑枠からインストール可能)。作成した.extファイルを選択してインストールしてください。
アプリ画面を開きます(下記画像の赤枠ボタン)。

...

Operation check

Install it on your camera (for example, you can install it from the green frame in the image below). Select the .ext file you created and install it. Open the app screen (red frame button in the image below).

...

If the image captured by the camera is displayed when you start the app, as shown below, then the app was successful.

...

外部ライブラリを追加する

任意の外部ライブラリを用いる場合はDockerfileを編集します。

...