Welcome to Deacon!

See:
          Description

Packages
org.deacon  
org.deacon.demo  
org.deacon.test  

 

Welcome to Deacon!

Deacon is a push notifications library intended for use on Android devices, but which is also usable in pure-Java form. Deacon is free and open-source software, and is produced by the members of The Deacon Project.

Deacon can be used in two "modes", pure-Java and Android. Each is detailed below.

Using Deacon in Android Apps

You can integrate Deacon into your Android app or service by creating a new Deacon object, configuring it, then subscribing the object's context to receive callbacks when push notifications are received.

  1. Ensure the Deacon source or JAR file is on your project's build path.
  2. Instantiate a Deacon object from within your Android Activity or Service:
    Deacon myDeacon = new Deacon("data.myserver.com", 4670, this);
  3. Configure the Deacon object:
    myDeacon.joinChannel("channelname", 0);
  4. Register your context with Deacon to receive callbacks:
    myDeacon.register(this);
  5. Start the Deacon service:
    myDeacon.start();

Using Deacon in Java programs

Using Deacon in pure-Java is just like using it in Android, except that instead of instantiating Deacon, you instantiate its parent class, DeaconService. The configuration is the same, but the instantiating context is not required when you make a new DeaconService, and you must start and stop the service.

Other configuration and features...