Box連携拡張 リパッケージガイド
Cookbook 269703

本ガイドでは、box-java-sdk-v10-repackager プロジェクトのビルドと
生成 JAR の配置手順を説明します。

前提条件
  - Java 17 以上（確認: java -version）
  - Maven 3.6.0 以上（確認: mvn -version）
  - インターネット接続（初回ビルド時に Maven Central からダウンロード）

  ※ JDK 21 以降をご利用の場合は、手順 3 のコマンド例を適宜読み替えてください。

-----------------------------------------------------------------------

手順 1. プロジェクトディレクトリへの移動

  cd <展開先パス>/box-java-sdk-v10-repackager

-----------------------------------------------------------------------

手順 2. 依存ライブラリのダウンロード（初回のみ）

  mvn dependency:resolve

  - Box Java SDK V10 および jackson / okhttp3 等をローカルキャッシュに保存します。
  - 初回は 3〜5 分程度かかります。
  - 成功すると末尾に [INFO] BUILD SUCCESS が表示されます。

-----------------------------------------------------------------------

手順 3. ビルド（リパッケージング）

  mvn clean package

  環境変数 JAVA_HOME が設定されていない場合：

    コマンドプロンプト:
      set "JAVA_HOME=<Java 17 インストール先>"
      set "PATH=%JAVA_HOME%\bin;%PATH%"
      mvn clean package

    PowerShell:
      $env:JAVA_HOME="<Java 17 インストール先>"
      $env:PATH="$env:JAVA_HOME\bin;$env:PATH"
      mvn clean package

  - 初回: 5〜10 分程度  /  2 回目以降: 1〜2 分程度

-----------------------------------------------------------------------

手順 4. 生成 JAR の確認

  target\ ディレクトリに以下のファイルが生成されていることを確認してください。

    box-java-sdk-v10-repackager-10.4.0-shaded.jar  ← リパッケージ版（これを使用）
    box-java-sdk-v10-repackager-10.4.0.jar          ← 元 JAR（使用しない）

  JAR の内容確認（オプション、コマンドプロンプト）:
    jar tf target\box-java-sdk-v10-repackager-10.4.0-shaded.jar | findstr "v10"

  org/example/box/v10/... と表示されれば、リパッケージ成功です。

-----------------------------------------------------------------------

手順 5. JAR の配置

  生成した shaded JAR を以下のディレクトリにコピーしてください。

    /webapp/WEB-INF/lib/

  以上でリパッケージプロジェクトのビルドと配置は完了です。

-----------------------------------------------------------------------

トラブルシュート

[Maven Central に接続できない場合]
  - ファイアウォール設定を確認してください。
  - プロキシが必要な場合は ~/.m2/settings.xml にプロキシ設定を追加してください。

[キャッシュをクリアしたい場合]
  - Windows: del /s %USERPROFILE%\.m2\repository
  - Mac/Linux: rm -rf ~/.m2/repository