クイックスタート (Shirates/Vision) for macOS

Environment

インストールの前に Tested Environments を確認してください。

注意: AI-Vision機能は現時点でmacOSでのみ利用できます。

インストール

以下の前提となるツールをインストールしてください。

注意: ユーザー名に非ASCII文字や空白を含むOSのアカウントを使用しないでください。以下のツールのいくつかは動作しない場合があります。


IntelliJ IDEA

インストールしていない場合はUltimate または COMMUNITYをダウンロードしてインストールしてください。 (COMMUNITYはオープンソース製品です)

https://www.jetbrains.com/idea/


Android Studio

インストールしていない場合はダウンロードしてインストールしてください。

https://developer.android.com/studio


Xcode (Mac only)

インストールしていない場合はApp StoreでXcodeを検索してインストールしてください。


Command Line Tools for Xcode (Mac only)

インストールしていない場合はターミナルウィンドウを開いて以下のコマンドを実行してください。

xcode-select --install


Homebrew (Macのみ)

インストールしていない場合は https://brew.sh/ を参考にしてインストールしてください。


Java Development Kit (JDK)

インストールしていない場合はインストールガイドを検索してインストールしてください。


node & npm

インストールしていない場合はインストールしてください。

(Macの場合)

NPMをbrewでインストールすることができます。ターミナルウィンドウを開いて以下を実行してください。

brew install node
node -v
npm -v

注意: appiumのインストールのトラブルを避けるために比較的新しいバージョンを使用してください。


Appium

新規インストール

npm install -g appium
appium -v

すでにappiumを使用中の場合は最新バージョンへアップデートしてください。

アップデートインストール

appium -v
npm uninstall -g appium
npm install -g appium
appium -v

テスト済みの環境を Tested Environments で確認してください。


UIAutomator2 driver

新規インストール

appium driver install uiautomator2

アップデートインストール

appium driver list
appium driver uninstall uiautomator2
appium driver install uiautomator2
appium driver list

テスト済みの環境を Tested Environments で確認してください。


XCUITest driver(Macのみ)

新規インストール

appium driver install xcuitest

アップデートインストール

appium driver list
appium driver uninstall xcuitest
appium driver install xcuitest
appium driver list

テスト済みの環境を Tested Environments で確認してください。


環境変数の設定 (Macのみ)

初期化スクリプト(.zshrc など)で環境変数を設定してください。

例

export ANDROID_SDK_ROOT=/Users/$USER/Library/Android/sdk
export PATH=$ANDROID_SDK_ROOT/emulator:$ANDROID_SDK_ROOT/tools:$ANDROID_SDK_ROOT/platform-tools:$PATH

注意: 上記セッティングを有効にするためにログアウト/ログインを実行してください。

例

export ANDROID_SDK_ROOT=/home/$USER/Android/Sdk
export PATH=$ANDROID_SDK_ROOT/emulator:$ANDROID_SDK_ROOT/tools:$ANDROID_SDK_ROOT/platform-tools:$PATH

AVD(Android Virtual Device)の設定

AVD作成のデモ

  1. Android Studioを開きます。
  2. メニューから Tools > Device Manager を選択します。
  3. [+]をクリックします。
  4. Pixcel 8を選択してNextをクリックします。
  5. UsideDownCake 34 Android 14.0 (Google Play)を選択してNextをクリックします。 (電卓アプリ を使用したデモではGoogle Play Storeが必要となります). Macではarm64のイメージを選択します。
  6. AVD名をPixel 8(Android 14)に設定します。
    Enable device frameはオフに設定します。
    Finishをクリックします。

shirates-vision-server のセットアップ

  1. shirates-vision-server をshirates-vision-server から入手します。
  2. プロジェクトを開きます(Package.swiftをXcodeで開きます)。バックグラウンド処理が完了するのを待ちます。
  3. Product > Destination > My Macを選択します。
  4. Product > Runを選択します。 [ NOTICE ] Server started on http://127.0.0.1:8081がログ出力されます。

デモンストレーション

デモンストレーションをやってみましょう。

shirates-core-vision-samples を入手する

  1. shirates-core-vision-samples_ja をshirates-core-vision-samples_jaから入手します。

プロジェクトを開く

  1. shirates-core-vision-samples_ja プロジェクトのディレクトリを Finder で開きます。
  2. build.gradle.kts を右クリックしてIntelliJ IDEAで開きます。

右クリックによるテスト実行を有効にする

  1. IntelliJ IDEA > Settings
  2. Build, Execution, Deployment > Build Tools > Gradle
  3. Run tests using を IntelliJ IDEA に設定します


AndroidSettingsVisionDemo を実行する

  1. shirates-core-vision-samples_ja プロジェクトをIntelliJ IDEAで開き、
    kotlin/demo/vision/AndroidSettingsVisionDemoを右クリックして
    Debug ‘AndroidSettingsVisionDemo’ 選択します
  2. コンソールにこのようなログが出力されます。
  3. リンクをクリックしてディレクトリを開きます。
  4. _Report(simple).html を開きます。


  5. AndroidSettingsVisionDemo@a.xlsxを開きます。


iOSSettingsVisionDemo を実行する

  1. shirates-core-vision-samples_enプロジェクトをIntelliJ IDEAで開き、
    src/test/Kotlin/demo/vision/iOSSettingsVisionDemoを右クリックして
    Debug ‘iOSSettingsVisionDemo’ を選択します。
  2. コンソールにこのようなログが出力されます。
  3. リンクをクリックしてログディレクトリを開きます。
  4. _Report(simple).htmlを開きます。


  5. iOSSettingsVisionDemo@i.xlsx を開きます。

Link