Skip to content

Latest commit

 

History

History
97 lines (77 loc) · 4.91 KB

README.md

File metadata and controls

97 lines (77 loc) · 4.91 KB
Raw

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.

  1. Select <YOUR_PROJECT> -> <YOUR_TARGET> -> Build Phases
  2. Click + -> New Copy Files Phase, then change Destination to Frameworks in new build phase
  3. 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"

Swift Package Manger Compatible

Carthage

MailCore 2 is available through Carthage.

Add this line to the Cartfile

github "MailCore/mailcore2"

Here you can find Instructions for install Carthage.

Carthage compatible

CocoaPods

MailCore 2 is available on CocoaPods.

For iOS:

pod 'mailcore2-ios'

For OS X:

pod 'mailcore2-osx'

CocoaPods Compatible

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