APNS

The library was inspired by Apns4erl

Warning

The older version of the library is available in 0.0.x-stable branch

Installation

1. Add apns to your list of dependencies in mix.exs:

   def deps do [{:apns, "~> 0.9.6"}] end

2. Ensure apns is started before your application:

   def application do [applications: [:apns]] end

Usage

Config the APNS app and define pools

config :apns,
  # Here goes "global" config applied as default to all pools started if not overwritten by pool-specific value
  callback_module:    APNS.Callback,
  timeout:            30,
  feedback_interval:  1200,
  support_old_ios:    true,
  expiry:    60,
  # Here are pools configs. Any value from "global" config can be overwritten in any single pool config
  pools: [
    # app1_dev_pool is the pool_name
    app1_dev_pool: [
      env: :dev,
      pool_size: 10,
      pool_max_overflow: 0,
      certfile: "/path/to/cert.pem",
      keyfile: "/path/to/key.pem"
    ],
    app1_prod_pool: [
      env: :prod,
      certfile: "/path/to/cert.pem",
      keyfile: "/path/to/key.pem",
      pool_size: 100,
      pool_max_overflow: 0
    ],
  ]

Config keys

* It should be noted that Apple will always try to deliver the message at least once. If it takes longer to send the message to Apple than the expiry offset it will still be delivered.

Pool keys

* WARNING: According to our tests a overflow other then zero is bad.

All pools defined in config will be started automatically

From here and now you can start pushing your PNs via APNS.push/2 and APNS.push/3:

message = APNS.Message.new
message = message
|> Map.put(:token, "0000000000000000000000000000000000000000000000000000000000000000")
|> Map.put(:alert, "Hello world!")
|> Map.put(:badge, 42)
|> Map.put(:extra, %{
  "var1" => "val1",
  "var2" => "val2"
})
APNS.push :app1_dev_pool, message

or

APNS.push :app1_prod_pool, "0000000000000000000000000000000000000000000000000000000000000000", "Hello world!"

Handling APNS errors and feedback

You can define a callback handler module via config param callback_module. The module should implement 2 functions:

• error/2 which receives %APNS.Error{} and token
• feedback/1 which receives %APNS.Feedback{}

  defmodule APNS.Callback do
    def error(error = %APNS.Error{}, token) do
      # handle error
    end

    def feedback(feedback = %APNS.Feedback{}) do
      # handle feedback
    end
  end

Structs

• %APNS.Message{}

defstruct [
  id: nil,
  expiry: 60,
  token: "",
  content_available: nil,
  alert: "",
  badge: nil,
  sound: "default",
  mutable_content: nil,
  priority: 10,
  extra: [],
  support_old_ios: nil
]

• %APNS.Error{}

defstruct [
  message_id: nil,
  status: nil,
  error: nil
]

• %APNS.Feedback{}

defstruct [
  time: nil,
  token: nil
]

• %APNS.Message.Loc{}

defstruct [
  title: "",
  body: "",
  title_loc_key: nil,
  title_loc_args: nil,
  action_loc_key: nil,
  loc_key: "",
  loc_args: [],
  launch_image: nil
]

Contribute

git clone [email protected]:chvanikoff/apns4ex.git
# update config/config.exs with the path to your cert (do not use your live cert)
mix test