net.i2p.android.ui

Class I2PAndroidHelper

java.lang.Object

net.i2p.android.ui.I2PAndroidHelper

public class I2PAndroidHelper
extends java.lang.Object

Since:

0.2

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	I2PAndroidHelper.Callback

Field Summary

Fields

Modifier and Type	Field and Description
static int	REQUEST_START_I2P
static java.lang.String	URI_I2P_ANDROID
static java.lang.String	URI_I2P_ANDROID_DONATE
static java.lang.String	URI_I2P_ANDROID_LEGACY

Constructor Summary

Constructors

Constructor and Description
I2PAndroidHelper(android.content.Context context)

Method Summary

Modifier and Type	Method and Description
boolean	areTunnelsActive() Check if tunnels are active.
void	bind() Try to bind to I2P Android.
void	bind(I2PAndroidHelper.Callback callback) Try to bind to I2P Android.
boolean	bind(android.content.ServiceConnection serviceConnection, int flags) Try to bind to I2P Android, using the provided ServiceConnection and flags.
boolean	isI2PAndroidInstalled() Check if I2P Android is installed.
boolean	isI2PAndroidRunning() Check if I2P Android is running.
void	promptToInstall(android.app.Activity activity) Show dialog - install I2P Android from market or F-Droid.
void	requestI2PAndroidStart(android.app.Activity activity) Show dialog - request that I2P Android be started.
void	unbind() Unbind from I2P Android.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

URI_I2P_ANDROID

public static final java.lang.String URI_I2P_ANDROID

See Also:

Constant Field Values

URI_I2P_ANDROID_DONATE

public static final java.lang.String URI_I2P_ANDROID_DONATE

See Also:

Constant Field Values

URI_I2P_ANDROID_LEGACY

public static final java.lang.String URI_I2P_ANDROID_LEGACY

See Also:

Constant Field Values

REQUEST_START_I2P

public static final int REQUEST_START_I2P

See Also:

Constant Field Values

Constructor Detail

I2PAndroidHelper

public I2PAndroidHelper(android.content.Context context)

Method Detail

bind

public void bind(I2PAndroidHelper.Callback callback)

Try to bind to I2P Android. Call this method from Activity.onStart().

Parameters:

callback - will be called once the helper has bound to the I2P app.

Since:

0.7

bind

public void bind()

Try to bind to I2P Android. Call this method from Activity.onStart().

If you need to be notified as soon as the helper has been bound to the I2P app, use bind(Callback) instead.

bind

public boolean bind(android.content.ServiceConnection serviceConnection,
                    int flags)

Try to bind to I2P Android, using the provided ServiceConnection and flags. Call this method from Service.onStartCommand(android.content.Intent, int, int). The ServiceConnection will be provided with an IBinder that can be converted to an net.i2p.android.router.service.IRouterState with IRouterState.Stub.asInterface(IBinder).

unbind

public void unbind()

Unbind from I2P Android. Call this method from Activity.onStop().

isI2PAndroidInstalled

public boolean isI2PAndroidInstalled()

Check if I2P Android is installed.

Returns:

true if I2P Android is installed, false otherwise.

promptToInstall

public void promptToInstall(android.app.Activity activity)

Show dialog - install I2P Android from market or F-Droid.

Parameters:

activity - the Activity this method has been called from.

isI2PAndroidRunning

public boolean isI2PAndroidRunning()

Check if I2P Android is running. If bind() has not been called previously, this will always return false.

Do not call this from Activity.onResume(). The Android lifecycle calls that method before binding the helper to the I2P app, so this will always return false. Use bind(Callback) instead and call this method inside the callback.

Returns:

true if I2P Android is running, false otherwise.

requestI2PAndroidStart

public void requestI2PAndroidStart(android.app.Activity activity)

Show dialog - request that I2P Android be started.

Parameters:

activity - the Activity this method has been called from.

areTunnelsActive

public boolean areTunnelsActive()

Check if tunnels are active. This is the best indicator that the default tunnels (such as the HTTP proxy tunnel at localhost:4444) are ready to be used. If bind() has not been called previously, this will always return false.

Do not call this from Activity.onResume(). The Android lifecycle calls that method before binding the helper to the I2P app, so this will always return false. Use bind(Callback) instead and call this method inside the callback.

Returns:

true if tunnels are active, false otherwise.

Since:

0.7