=========================================
Jinrikisha オフライン環境での使用について
=========================================

この文書ではJinrikishaをオフライン環境（インターネットに接続できない環境）で使用する場合の設定や注意事項を説明します。

インストール
============
Jinrikishaを使ったAsakusa Framework開発環境のセットアップはオンライン環境（インターネットに接続出来る環境）でのみ可能です。

セットアップ後の開発環境は、後述する手順に従って設定を行うことで、オフライン環境での開発が可能です。

開発環境をオフライン環境で使用する
==================================

:doc:`install` に従って構築した開発環境をオフラインで使用するための方法を解説します。

Gradleをオフラインモードで使用する
----------------------------------

Gradleをオフラインモードで使用するには、Gradleのコマンドラインオプションに ``--offline`` を指定して実行します。

..  code-block:: sh

    ./gradlew --offline ...

より詳しくは、以下のドキュメントなどを参考にしてください。

* http://gradle.monochromeroad.com/docs/userguide/dependency_management.html#sec:cache_command_line_options

アプリケーション開発プロジェクトの作成
--------------------------------------

新規でアプリケーション開発プロジェクトを作成する場合、通常は `Asakusa Gradle Plugin利用ガイド`_ に従い、Asakusa Frameworkが公開しているプロジェクトテンプレートを使用します。
このテンプレートファイルをあらかじめ開発環境に配置しておけば、オフライン環境で新規プロジェクトを作成することができます。

..  attention::
    Gradleを使ったビルド時に、オフライン環境ではじめて実行するタスクを指定した場合は、開発環境に必要なライブラリがキャッシュされていないためにビルドが失敗する可能性があります。
    その場合、一度Gradleをオンラインモードに戻してオンライン環境でビルドを行い、必要なライブラリをダウンロードしてください。

..  _`Asakusa Gradle Plugin利用ガイド`: https://docs.asakusafw.com/latest/release/ja/html/application/gradle-plugin.html

依存ライブラリの追加について
----------------------------

アプリケーションプロジェクトで追加のライブラリを使用する場合、 `Asakusa Gradle Plugin利用ガイド`_ の 「アプリケーション用依存ライブラリの追加」を参考にして開発環境にライブラリファイルを配置してください。