embed guide update

This commit is contained in:
zzz
2017-11-08 13:24:35 +00:00
parent 9ec80cfceb
commit 2c09bebea8

View File

@@ -1,7 +1,7 @@
{% extends "global/layout.html" %}
{% block title %}{% trans %}Embedding I2P in your Application{% endtrans %}{% endblock %}
{% block lastupdated %}{% trans %}April 2015{% endtrans %}{% endblock %}
{% block accuratefor %}0.9.19{% endblock %}
{% block lastupdated %}{% trans %}November 2017{% endtrans %}{% endblock %}
{% block accuratefor %}0.9.32{% endblock %}
{% block content %}
<h2>{% trans %}Overview{% endtrans %}</h2>
@@ -221,9 +221,8 @@ At a minimum you will need i2p.jar, router.jar, streaming.jar, and mstreaming.ja
You may omit the two streaming jars for a datagram-only app.
Some apps may need more, e.g. i2ptunnel.jar or addressbook.jar.
Don't forget jbigi.jar, or a subset of it for the platforms you support, to make the crypto much faster.
We are currently building them for Java 6, as of 0.9.14. The source is mostly compatible with Java 5 if you want to do your own compile,
but we may start using Java 6 features at any time without notice.
We plan to migrate to Java 7 in 2015.
We are currently building them for Java 7, as of 0.9.24. The source is mostly compatible with Java 6 if you want to do your own compile,
but we may start using Java 7 features at any time without notice.
If you're building Debian / Ubuntu packages, you should require the I2P package from our PPA instead of bundling it.
You almost certainly do not need susimail, susidns, the router console, and i2psnark, for example.
{%- endtrans %}</p>
@@ -244,13 +243,41 @@ License requirements may require you to include the LICENSES.txt file and the li
You may also wish to bundle a hosts.txt file.
{%- endtrans %}</li>
<li>{% trans -%}
Be sure to specify a Java 6 bootclasspath if compiling with Java 8.
Be sure to specify a Java 7 bootclasspath if compiling with Java 8.
{%- endtrans %}</li>
</ul>
</p>
<h3>{% trans %}Android considerations{% endtrans %}</h3>
<p>{% trans -%}
Our Android router app may be shared by multiple clients.
If it is not installed, the user will be prompted when he starts a client app.
{%- endtrans %}</p>
<p>{% trans -%}
Some developers have expressed concern that this is a poor user experience,
and they wish to embed the router in their app.
We do have an Android router service library on our roadmap, which could make embedding easier.
More information needed.
{%- endtrans %}</p>
<p>{% trans -%}
If you require assistance, please contact us.
{%- endtrans %}</p>
<h3>{% trans %}Maven jars{% endtrans %}</h3>
<p>{% trans -%}
We have a limited number of our jars on <a href="http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22net.i2p%22">Maven Central</a>.
There are numerous trac tickets for us to address that will improve and expand the released jars on Maven Central.
{%- endtrans %}</p>
<p>{% trans -%}
If you require assistance, please contact us.
{%- endtrans %}</p>
<h3>{% trans %}Datagram (DHT) considerations{% endtrans %}</h3>
<p>{% trans -%}
If your application is using I2P datagrams, e.g. for a DHT,