import app into fdroid directly from git clone

This adds a new method for `fdroid import` that will generate the fdroidserver
metadata based on a local git repo.  This new mode generates the metadata in
the new .fdroid.yaml format in the git repo itself.  It is intended as a quick
way to get starting building apps using the fdroidserver tools.
This commit is contained in:
Hans-Christoph Steiner 2016-03-21 21:00:12 +01:00
parent 994488ad47
commit 19189b9b04
3 changed files with 65 additions and 22 deletions

View file

@ -401,19 +401,32 @@ the signed output directory were modified, you won't be notified.
@node Importing Applications
@chapter Importing Applications
To help with starting work on including a new application, @code{fdroid import}
will take a URL and optionally some other parameters, and attempt to construct
as much information as possible by analysing the source code. Basic usage is:
To help with starting work on including a new application, use
@code{fdroid import} to set up a new template project. It has two
modes of operation, starting with a cloned git repo:
@example
git clone https://gitlab.com/fdroid/fdroidclient
cd fdroidclient
fdroid import
@end example
Or starting with a URL to a project page:
@example
fdroid import --url=http://address.of.project
@end example
For this to work, the URL must point to a project format that the script
When a URL is specified using the @code{--url=} flag, @code{fdroid
import} will use that URL to find out information about the project,
and if it finds a git repo, it will also clone that. For this to
work, the URL must point to a project format that the script
understands. Currently this is limited to one of the following:
@enumerate
@item
GitLab - @code{https://gitlab.com/PROJECTNAME/REPONAME}
@item
Gitorious - @code{https://gitorious.org/PROJECTNAME/REPONAME}
@item
Github - @code{https://github.com/USER/PROJECT}