androidアプリ 外部ライブラリの置き場所

Question

androidアプリ作成を学習し始めたばかりの者ですが、外部ライブラリの扱い方がよくわかりません。

現在作成中のプロジェクトにtess-twoを取り入れようとしています。
外部ライブラリの使用には何通りか方法が存在するみたいですが、今回はプロジェクト直下build.gradle内に

dependencies{
    implementation 'com.rmtheis:tess-two:9.0.0'
}

を追加する方法で実現したいと考えています。

dependenciesは、プロジェクトが依存しているサブプロジェクトを表しているものだと理解しており、だとすればプロジェクト内にtess-twoプロジェクトがサブプロジェクトとして存在しているのが前提になると思いますが、tess-twoライブラリ(サブプロジェクト?)をどこに置けばよいのかがわかりません。

そもそも前述の理解(「だとすれば～])が間違っていて、どこか別のところから参照するものなのか、またcom.rmtheis:tess-two:9.0.0部分がどこを表しているのかなども含めてお尋ねしたいです。
よろしくお願いします。

Answer 1

外部参照

質問にある

dependencies{
    implementation 'com.rmtheis:tess-two:9.0.0'
}

のような記述は、外部依存関係の設定です。Android Studioプロジェクトを作成したとき、プロジェクトルート直下のbuild.gradleに

allprojects {
    repositories {
        google()
        jcenter()
    }
}

という記述がありますが、これが外部参照するネットワークリポジトリーの設定となります。jcenter()はBintray jcenterを外部参照するための定義となっていて、tess-twoもここに存在します。なお、google()はSupport LibraryやGoogle APIsなどを外部参照ためのものです。

ローカルの他プロジェクトから参照

外部参照せず、ローカルにダウンロードした他プロジェクトから参照する方法もあります。自分の作成したプロジェクトのsettings.gradleに

include ':tess-two'
project(':tess-two').projectDir = new File('../tess-two-master/tess-two')

のように記述して、自プロジェクトルートから見たtess-twoモジュールのパスを指定することで、tess-twoモジュールを自プロジェクトに加えることができます。このモジュールを自プロジェクトのappモジュールで参照するには、app/build.gradleに

dependencies{
    implementation project(':tess-two')
}

という記述を加えます。

ただし、この場合はtess-twoモジュールのビルドが通るようにするために、自プロジェクトのルート直下にあるbuild.gradleも修正を加える必要があるでしょう。

aarファイルを参照

tess-two-masterプロジェクトをAndroid Studioでビルドすると、ライブラリーとしてaarファイルが作成されます。このaarを自分のプロジェクトに取り込む方法もあります。

自分のプロジェクトで、File→New→New Module...と選択し、表示されたダイアログの下の方にあるImport .JAR/.AAR Packageを選択します。次の画面で、File nameの右端にあるボタンをクリックして、tess-twoモジュールで作成されたaarファイルを選択（プロジェクトルートから見て、tess-two/build/outputs/aar/の下にあるはず）します。ここでSubproject nameに設定した名前を以降で用います。

完了したら、settings.gradleに

include ':tess-two'

を追記（tess-twoの部分はSubproject name）し（projectDirを設定する必要はありません）、app/build.gradleに

dependencies{
    implementation project(':tess-two')
}

を追記すれば完了です。

Answer 2

implementation 'com.rmtheis:tess-two:9.0.0'

こう書くとサーバーからライブラリをとってきて自動で追加してくれるので
特に何も用意しなくていいです。

Comments

[Soudaro]

回答ありがとうございます。

ってことはimplementationで外部ライブラリを引用したアプリは、オフライン環境では動作しないってことになるんですかね…？

[退会済みユーザー]

一度GradleファイルをSyncするときにとってきてローカルに置かれますが、完全オフラインの状態からだと空になったと思います・・・