/usr/share/doc/fdroidserver/html/html_node/Simple-Binary-Repository.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: Simple Binary Repository</title>

<meta name="description" content="F-Droid Server Manual: Simple Binary Repository">
<meta name="keywords" content="F-Droid Server Manual: Simple Binary Repository">
<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="Building-Applications.html#Building-Applications" rel="next" title="Building Applications">
<link href="Setup.html#Setup" rel="prev" title="Setup">
<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="Simple-Binary-Repository"></a>
<div class="header">
<p>
Next: <a href="Building-Applications.html#Building-Applications" accesskey="n" rel="next">Building Applications</a>, Previous: <a href="Setup.html#Setup" accesskey="p" rel="prev">Setup</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="Simple-Binary-Repository-1"></a>
<h2 class="chapter">4 Simple Binary Repository</h2>

<a name="index-binary"></a>

<p>If you want to maintain a simple repository hosting only binary APKs obtained
and compiled elsewhere, the process is quite simple:
</p>
<ol>
<li> Set up the server tools, as described in Setup.
</li><li> Make a directory for your repository. This is the directory from which you
will do all the work with your repository. Create a config file there, called
<code>config.py</code>, by copying the <code>config.sample.py</code> from the server
project and editing it.
</li><li> Within that, make a directory called <code>repo</code> and put APK files in it.
</li><li> Run <code>fdroid update</code>.
</li><li> If it reports that any metadata files are missing, you can create them
in the <code>metadata</code> directory and run it again.
</li><li> To ease creation of metadata files, run <code>fdroid update</code> with the <code>-c</code>
option. It will create &rsquo;skeleton&rsquo; metadata files that are missing, and you can
then just edit them and fill in the details.
</li><li> Then, if you&rsquo;ve changed things, run <code>fdroid update</code> again.
</li><li> Running <code>fdroid update</code> adds an Icons directory into the repo directory,
and also creates the repository index (index.xml, and also index.jar if you&rsquo;ve
configured the system to use a signed index).
</li><li> Publish the resulting contents of the <code>repo</code> directory to your web server.
</li></ol>

<p>Following the above process will result in a <code>repo</code> directory, which you
simply need to push to any HTTP (or preferably HTTPS) server to make it
accessible.
</p>
<p>While some information about the applications (and versions thereof) is
retrieved directly from the APK files, most comes from the corresponding file
in the <code>metadata</code> directory. The metadata file covering ALL versions of a
particular application is named <code>package.id.txt</code> where package.id is the
unique identifier for that package.
</p>
<p>See the Metadata chapter for details of what goes in the metadata file. All
fields are relevant for binary APKs, EXCEPT for <code>Build:</code> entries, which
should be omitted.
</p>

<hr>
<div class="header">
<p>
Next: <a href="Building-Applications.html#Building-Applications" accesskey="n" rel="next">Building Applications</a>, Previous: <a href="Setup.html#Setup" accesskey="p" rel="prev">Setup</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 / Simple-Binary-Repository.html
