新しいアプリケーションの収載作業を開始するには、fdroid import
を使用して新しいテンプレートプロジェクトをセットアップします。これには、クローン済みのGitリポジトリから始める2つの動作モードがあります:
git clone https://gitlab.com/fdroid/fdroidclient
cd fdroidclient
fdroid import
または、プロジェクトページのURLから始める場合:
fdroid import --url=http://address.of.project
--url= フラグを使用してURLを指定すると、fdroid import
はそのURLを使ってプロジェクトに関する情報を調べ、Gitリポジトリが見つかった場合はそれもクローンします。これが機能するには、URLがスクリプトで認識できるプロジェクト形式を指している必要があります。現在、これは次のいずれかに限定されています:
- GitLab -
https://gitlab.com/<PROJECTNAME>/<REPONAME> - GitHub -
https://github.com/<USER>/<PROJECT> - Bitbucket -
https://bitbucket.org/<USER>/<PROJECT>/ - NotABug -
https://notabug.org/<USER>/<PROJECT> - Git -
git://<REPO>またはhttps://<REPO>
プロジェクトの種類によって、収集される情報の量は増減します。git:// のようなベアリポジトリURLは、手動で入力する必要がある情報がかなり多くなるため、最も推奨されない選択肢です。gradle ベースのビルドはすべての種類で自動検出されるはずですが、プレーンなgitプロジェクトではissue trackerへのリンクを設定できません。次の引数のいずれかを使用して、メタデータを事前入力することもできます:
-u <URL>、--url=<URL>: インポート元のプロジェクトURL。-s <DIR>、--subdir=<DIR>: メインAndroidプロジェクトがルートにない場合、そのサブディレクトリのパス。-c <CATEGORIES>、--categories=<CATEGORIES>: カンマ区切りのカテゴリー一覧。-l <LICENSE>、--license=<LICENSE>: プロジェクト全体のライセンス。--revision <REV>: 初回インポートに別のリビジョン（またはGitブランチ）を指定できます
インポートに成功すると、メタデータファイルが作成されます。情報を確認し、空欄を埋めるために、このファイルをさらに編集する必要があります。
失敗した場合は、その理由が表示されます。ソースコードの取得まで進んでいた場合は、完全なチェックアウトが存在する tmp/importer
を確認して、さらに調べることができます。
初回に失敗するよくある原因は、プロジェクトディレクトリが実際にはリポジトリ内のサブディレクトリになっていることです。この場合は、--subdir
オプションを使用してインポーターを再実行し、その場所を指定してください。候補が複数ある場合があるため、自動的には判定されません。
