/usr/share/doc/fdroidserver/html/html_node/Importing-Applications.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for the F-Droid repository server tools.

Copyright (C) 2010, 2011, 2012, 2013 Ciaran Gultnieks

Copyright (C) 2011 Henrik Tunedal, Michael Haas, John Sullivan

Copyright (C) 2013 David Black

Copyright (C) 2013, 2014 Daniel Martí

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled "GNU
Free Documentation License". -->
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>F-Droid Server Manual: Importing Applications</title>

<meta name="description" content="F-Droid Server Manual: Importing Applications">
<meta name="keywords" content="F-Droid Server Manual: Importing Applications">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Index.html#Index" rel="index" title="Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="Metadata.html#Metadata" rel="next" title="Metadata">
<link href="Building-Applications.html#Building-Applications" rel="prev" title="Building Applications">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Importing-Applications"></a>
<div class="header">
<p>
Next: <a href="Metadata.html#Metadata" accesskey="n" rel="next">Metadata</a>, Previous: <a href="Building-Applications.html#Building-Applications" accesskey="p" rel="prev">Building Applications</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Importing-Applications-1"></a>
<h2 class="chapter">6 Importing Applications</h2>

<p>To help with starting work on including a new application, <code>fdroid import</code>
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:
</p>
<div class="example">
<pre class="example">./fdroid import --url=http://address.of.project
</pre></div>

<p>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:
</p>
<ol>
<li> Gitorious - <code>https://gitorious.org/PROJECTNAME/REPONAME</code>
</li><li> Github - <code>https://github.com/USER/PROJECT</code>
</li><li> Google Code - <code>http://code.google.com/p/PROJECT/</code>
Supports git, svn and hg repos.

<p>Some Google Code projects have multiple repositories, identified by a
dropdown list on the <code>source/checkout</code> page. To access one other than
the default, specify its name using the <code>--repo</code> switch.
</p></li><li> Bitbucket - <code>https://bitbucket.org/USER/PROJECT/</code>
</li><li> Git - <code>git://REPO</code>
</li></ol>

<p>Depending on the project type, more or less information may be gathered. For
example, the license will be retrieved from a Google Code project, but not a
GitHub one. A bare repo url, such as the git:// one, is the least preferable
optional of all, since you will have to enter much more information manually.
</p>
<p>If the import is successful, a metadata file will be created. You will need to
edit this further to check the information, and fill in the blanks.
</p>
<p>If it fails, you&rsquo;ll be told why. If it got as far as retrieving the source
code, you can inspect it further by looking in <code>tmp/importer</code> where a full
checkout will exist.
</p>
<p>A frequent cause of initial failure is that the project directory is actually
a subdirectory in the repository. In this case, run the importer again using
the <code>--subdir</code> option to tell it where. It will not attempt to determine
this automatically, since there may be several options.
</p>

<hr>
<div class="header">
<p>
Next: <a href="Metadata.html#Metadata" accesskey="n" rel="next">Metadata</a>, Previous: <a href="Building-Applications.html#Building-Applications" accesskey="p" rel="prev">Building Applications</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
fdroidserver 0.2.1-4 / usr / share / doc / fdroidserver / html / html_node / Importing-Applications.html
