Fork me on GitHub

MailCore

An e-mail library for Mac & iOS

logo

Summary

What is MailCore?

MailCore is a Mac and iOS library designed to ease the pain of dealing with e-mail protocols. MailCore makes the process of sending e-mail easy by hiding the nasty details like MIME composition from you. Instead, there is a single method required to send a message. Checking e-mail on an IMAP server is a more complex beast, but MailCore makes the job much simpler by presenting everything as a set of objects like Messages, Folders and Accounts.

Example

This example shows how you can send email using MailCore.

Getting the Code

The best way to get MailCore is to clone directly from GitHub. The master branch is under active development but it is still the recommended place to start. Eventually a stable version will be tagged 1.0, but for now work off master. 

git clone https://github.com/mronge/MailCore.git
cd MailCore/
git submodule update --init

Adding MailCore to Your iOS Project

  1. First checkout the latest code and make sure you get the required submodules
  2. Locate MailCore.xcodeproj and add it to your project as a subproject. You can do this by dragging the Mailcore.xcodeproj file into your Xcode project.
    subproject
  3. Navigate to your app’s target and switch to your app’s Build Phases. Once in Build Phases expand “Link Binary With Libraries” and click the + button. And add these libraries:
   libmailcore.a
   libssl.a
   libsasl2.a
   libcrypto.a
   libiconv.dylib
   CFNetwork.framework

libraries
4. Add “MailCore iOS” under “Target Dependencies”
5. Under your app’s target, switch to Build Settings. Locate “Header Search Paths” in the Build Settings and add "$(BUILT_PRODUCTS_DIR)/../../include"
6. You are now ready to use MailCore. To use MailCore add #import <MailCore/MailCore.h> to the top of your Objective-C files.

Adding MailCore to Your Mac Project

  1. First checkout the latest code and make sure you get the required submodules
  2. Locate MailCore.xcodeproj and add it to your project as a subproject. You can do this by dragging the Mailcore.xcodeproj file into your Xcode project.
  3. Navigate to your app’s target and switch to your app’s Build Phases. Once in Build Phases expand “Link Binary With Libraries” and click the + button. From there add MailCore.framework.
  4. While still under Build Phases click “Add Build Phase” in the lower right and select “Add Copy Files”. A new copy files phase will be added, make sure the destination is set to “Frameworks”. Now add MailCore.framework to that copy files phase by using the + button.
  5. Add “MailCore” under “Target Dependencies”
  6. You are now ready to use MailCore. To use MailCore add #import <MailCore/MailCore.h> to the top of your Objective-C files.

Documentation

Begin with the Getting Started Guide and then take a look at the API docs.

For those of you coming from an older version of MailCore, take a look at themigration guide.

Mailing List

There is a low traffic mailing list hosted on Librelist.

Apps Using MailCore

If you’d like your app listed here, please get in touch.

Consulting

Consulting services are available via Central Atomics. At Central Atomics we have over 10 years of experience developing for Apple platforms and 6 years of experience working with e-mail systems. If you need custom e-mail functionality developed, please get in touch via our website or e-mail Matt directly.

Contact

If you have any questions please don’t hesitate to contact me.

Thanks,

Matt Ronge
mronge@mronge.com
@mronge

Logo designed by Adan Perez. The logo is a modified version of the Mail icon by The Noun Project, used under a CC BY license.
© 2012 Matt Ronge. All Rights Reserved.