README.md

Swift Package Manager

MailCore 2 is available through Swift Package Manager.

1. In Xcode click File -> Swift Packages -> Add Package Dependency...
2. Paste the following URL: https://github.com/MailCore/mailcore2
3. On the Choose Package Options screen, under Rules switch from Version to Branch (Branch: master) will be the default
4. Click Next -> Next -> Finish

The following steps are to resolve an issue with the current version of Xcode 12, once the issue is fixed they will be unnecessary and removed.

4. Select <YOUR_PROJECT> -> <YOUR_TARGET> -> Build Phases
5. Click + -> New Copy Files Phase, then change Destination to Frameworks in new build phase
6. Click + -> New Run Script Phase, then paste the script box:

if [ "$PLATFORM_NAME" == "macosx" ]
then
    FRAMEWORK_PATH="$CODESIGNING_FOLDER_PATH"/Contents/Frameworks/MailCore.framework/Versions/A/MailCore
else
    FRAMEWORK_PATH="$CODESIGNING_FOLDER_PATH"/Frameworks/MailCore.framework
fi
echo "Signing framework at: $FRAMEWORK_PATH"
/usr/bin/codesign --force --sign ${EXPANDED_CODE_SIGN_IDENTITY} --preserve-metadata=identifier,entitlements "$FRAMEWORK_PATH"

Carthage

MailCore 2 is available through Carthage.

Add this line to the Cartfile

github "MailCore/mailcore2"

Here you can find Instructions for install Carthage.

CocoaPods

MailCore 2 is available on CocoaPods.

For iOS:

pod 'mailcore2-ios'

For OS X:

pod 'mailcore2-osx'

Binary

For iOS: Download the latest build for iOS.

For OS X: Download the latest build for OS X.

Build for iOS/OSX

1. If you're migrating from MailCore1, you should first clean your build folder.
2. Checkout MailCore2 into a directory relative to your project.
3. Under the build-mac directory, locate the mailcore2.xcodeproj file, and drag this into your Xcode project.
4. For Mac - If you're building for Mac, you can either link against MailCore 2 as a framework, or as a static library:
   • Mac framework
     • Go to Build Phases from your build target, and under 'Link Binary With Libraries', add MailCore.framework and Security.framework.
     • Make sure to use LLVM C++ standard library. Open Build Settings, scroll down to 'C++ Standard Library', and select libc++.
     • In Build Phases, add a Target Dependency of mailcore osx (it's the one with a little toolbox icon).
     • Goto Editor > Add Build Phase > Copy Files.
     • Expand the newly created Build Phase and change it's destination to "Frameworks".
     • Click the + icon and select MailCore.framework.
   • Mac static library
     • Go to Build Phases from your build target, and under 'Link Binary With Libraries', add libMailCore.a and Security.framework.
     • Set 'Other Linker Flags' under Build Settings: -lctemplate -letpan -lxml2 -lsasl2 -liconv -ltidy -lz -lc++ -stdlib=libc++ -ObjC -lresolv
     • Make sure to use LLVM C++ standard library. In Build Settings, locate 'C++ Standard Library', and select libc++.
     • In Build Phases, add a Target Dependency of static mailcore2 osx.
5. For iOS - If you're targeting iOS, you have to link against MailCore 2 as a static library:
   • Add libMailCore-ios.a
   • Add CFNetwork.framework
   • Add Security.framework
   • Set 'Other Linker Flags': -lctemplate-ios -letpan-ios -lxml2 -lsasl2 -liconv -ltidy -lz -lc++ -lresolv -stdlib=libc++ -ObjC
   • Make sure to use LLVM C++ standard library. Open Build Settings, scroll down to 'C++ Standard Library', and select libc++.
   • In Build Phases, add a Target Dependency of static mailcore2 ios.
6. For Swift - If you are using Mailcore in a Swift project you also need to complete the following steps:
   • Create a new header file in your project and name it Project-Name-Bridging-Header.h.
   • Remove any template code from the file and add #import <MailCore/MailCore.h>
   • In your target settings search for Objective-c Bridging Header and add a link to your bridging header.
   • You do not need to import Mailcore in any of your classes as the bridging header takes care of this automatically.
7. Profit.

Here's a video that shows all the steps for iOS: http://www.youtube.com/watch?v=9fAo6oBzlQI