SUBMAIL SWIFT SDK


概览


更新 IOS 9.0 与 SWIFT 2.0支持

支持iOS版本:iOS7 以上

代码编码格式:utf-8

需要手动指定 Submail-Bridging-Header.h 文件的路径,在 Xcode 工程的 Build Settings 中找到 Objective-C Bridging Header 选项,添加“$PROJECT_NAME/Submail/Utils/Submail-Bridging-Header.h”,如图:

img



下载


SUBMAIL_SWIFT_SDK_MAIL_AND_MESSAGE_WITH_ADDRESSBOOK 邮件、短信和地址薄

前往 GitHup 下载




文件目录索引


Config目录处理用户的配置信息
Config.swiftMailConfigMessageConfig 的父类
Demo 目录代码示例目录
AddressbookMailSubscribeDemo.swift邮件地址薄,订阅和添加联系人到目标地址薄
AddressbookMailUnSubscribeDemo.swift邮件地址薄,退订和从目标地址薄移除联系人
AddressbookMessageSubscribeDemo.swift短信地址薄,订阅和添加联系人到目标地址薄
AddressbookMessageUnSubscribeDemo.swift短信地址薄,退订和从目标地址薄移除联系人
MailSendDemo.swiftmail/send API 代码示例和使用指引
MailXSendDemo.swiftmail/xsend API 代码示例和使用指引
MessageXSendDemo.swiftmessage/xsend API 代码示例和使用指引
Lib 目录SDK 资源目录
AddressbookMail.swift邮件地址薄 API
AddressbookMessage.swift短信地址薄 API
Mail.swift邮件 API
MailSend.swiftmail/send API
MailXSend.swiftmail/xsend API
Message.swift短信 API
MessageXSend.swiftmessage/xsend API
Utils 目录md5sha1的扩展
NSString+Helper.m实现了md5sha1的扩展
NSString+Helper.h实现了 md5sha1的扩展接口
Submail-Bridging-Header.hSwift 调用 OC 接口的头文件




开始使用


导入以下第三方库文件

AFNetworking2.4.1


SDK Class 索引


MailSend.swiftmail/send API
MailXSend.swiftmail/xsend API
MessageXSend.swiftmessage/xsend API
AddressbookMail.swift邮件地址簿 API
AddressbookMessage.swift短信地址簿 API



MailSend


初始化类
var submail = MailSend(config: MailConfig())


使用指引
方法描述示例
add_to添加邮件地址到 To 数组,第一个必选参数:邮件地址。第二个可选参数:收件人姓名submail.add_to("leo@submail.cn", "leo")
add_addressbook添加地址薄标识到 addressbook 数组submail.add_addressbook("subscribe")
set_from设置发件人,第一个必选参数:邮件地址。第二个可选参数:显示名称submail.set_from("leo@submail.cn", "leo")
set_reply设置回复地址submail.set_reply("leo@submail.cn")
add_cc添加抄送地址submail.add_cc("leo@submail.cn")
add_bcc添加密送地址submail.add_bcc("leo@submail.cn")
set_subject设置邮件标题submail.set_subject("test SDK")
set_text设置文本邮件内容submail.set_text("test SDK text")
set_html设置 HTML 邮件内容submail.set_html("test SDK html")
add_var添加文本变量到 vars 数组submail.add_var("name","leo")
add_link添加超链接变量到 links 数组submail.add_link("developer","http://submail.cn/chs/developer")
add_headers添加自定义邮件头指令到 headers 数组submail.add_headers("X-Mailer","My App")
add_attachment添加附件到 attachments 数组submail.add_attachment("//path//to//file.txt")
send()发送邮件submail.send()
代码示例

使用 MailSend 类提交 mail/send 发送一封简单的邮件


import Foundation

public class MailSendDemo {
    public class func demo() {
        var submail = MailSend(config: MailConfig())
        submail.add_to("leo@submail.cn", "leo")        
        submail.set_from("no-reply@submail.cn", "SUBMAIL")
        submail.set_subject("testSDK")
        submail.set_text("test SDK text")
        submail.set_html("test SDK html")        
        submail.send()
    }
}



MailXSend


初始化类
var submail = MailXSend(config: MailConfig())
使用指引
方法描述示例
add_to添加邮件地址到 To 数组,第一个必选参数:邮件地址。第二个可选参数:收件人姓名submail.add_to("leo@submail.cn", "leo")
add_addressbook添加地址薄标识到 addressbook 数组submail.add_addressbook("subscribe")
set_from设置发件人,第一个必选参数:邮件地址。第二个可选参数:显示名称submail.set_from("leo@submail.cn", "leo")
set_reply设置回复地址submail.set_reply("leo@submail.cn")
add_cc添加抄送地址submail.add_cc("leo@submail.cn")
add_bcc添加密送地址submail.add_bcc("leo@submail.cn")
set_subject设置邮件标题submail.set_subject("test SDK");
set_project设置邮件项目标识submail.set_project ("THJBE4")
add_var添加文本变量到 vars 数组submail.add_var("name", "leo")
add_link添加超链接变量到 links 数组submail.add_link("developer","http://submail.cn/chs/developer")
add_headers添加自定义邮件头指令到 headers 数组submail.add_headers("X-Mailer","My App")
xsend()发送邮件submail.xsend()
代码示例

使用 MailXSend 类提交 mail/xsend 发送一封邮件。


import Foundation

public class MailXSendDemo {
    public class func demo() {
        var submail = MailXSend(config: MailConfig())
        submail.add_to("leo@submail.cn", "leo")
        submail.set_from("no-reply@submail.cn", "SUBMAIL")
        submail.set_project("wAWzY4")
        submail.add_var("name", "leo")
        submail.add_var("age", "32")
        submail.add_link("developer", "http://submail.cn/chs/developer")
        submail.add_link("store", "http://submail.cn/chs/store")
        submail.add_headers("X-Accept", "zh-cn")
        submail.add_headers("X-Mailer", "leo App")
        submail.xsend()
    }
}



MessageXSend


初始化类
var submail = MessageXSend(config: MessageConfig())


使用指引
方法描述示例
add_to添加11位手机号码到 To 数组submail.add_to("138xxxxxxxx")
add_addressbook添加地址薄标识到 addressbook 数组submail.add_addressbook("subscribe")
set_project设置短信项目标记submail.set_project("THJBE4")
add_var添加文本变量到 vars 数组submail.add_var("name", "leo")
xsend()发送短信submail.xsend()


代码示例

使用 MessageXSend 类提交 message/xsend 发送一条触发短信。


import Foundation

public class MessageXSendDemo {
    public class func demo() {
        var submail = MessageXSend(config: MessageConfig())
        submail.add_to("138********")
        submail.set_project("kZ9Ky3")
        submail.add_var("code", "198276")
        submail.xsend()
    }
}



AddressbookMail


初始化类
var addressbook = AddressbookMail(config: MailConfig())


使用指引
方法描述示例
set_address设置邮件地址,第一个必选参数:邮件地址。第二个可选参数:收件人姓名submail.set_address("leo@submail.cn", "leo")
set_addressbook设置目标地址薄标识submail.set_addressbook("subscribe")
subscribe()订阅或添加联系人submail.subscribe()
unsubscribe()退订或移除联系人submail.unsubscribe()


代码示例

使用 AddressbookMail 类提交 addressbook/mail/subscribe 请求,添加订阅联系人或向目标地址薄中添加联系人


import Foundation

public class AddressbookMailSubscribeDemo {
    public class func demo() {
        var addressbook = AddressbookMail(config: MailConfig())
        addressbook.set_address("leo@submail.cn", "leo")
        addressbook.subscribe()
    }
}

使用 AddressbookMail 类 发送 addressbook/mail/unsubscribe 请求,添加退订联系人或从目标地址薄中移除联系人


import Foundation

public class AddressbookMailUnsubscribeDemo {
    public class func demo() {
        var addressbook = AddressbookMail(config: MailConfig())
        addressbook.set_address("leo@submail.cn", "leo")
        addressbook.unsubscribe() 
    }
}


AddressbookMessage


初始化类
var addressbook = new AddressbookMessage(config: MessageConfig())


使用指引
方法描述示例
set_address设置联系人11位手机号码submail.set_address("138xxxxxxxx")
set_addressbook设置目标地址薄标识submail.add_addressbook("subscribe")
subscribe()订阅或添加联系人submail.subscribe()
unsubscribe()退订或移除联系人submail.unsubscribe()


代码示例

使用 AddressbookMessage 类 发送 addressbook/message/subscribe 请求,添加订阅联系人或向目标地址薄中添加联系人


import Foundation

public class AddressbookMessageSubscribeDemo {
    public class func demo() {
       
var addressbook = AddressbookMessage(config: MessageConfig())
        addressbook.set_address("138xxxxxxxx")
        addressbook.subscribe()
    }
}

使用 AddressbookMessage 类发送 addressbook/message/unsubscribe 请求,添加退订联系人或从目标地址薄中移除联系人


import Foundation

public class AddressbookMessageUnsubscribeDemo {
    public class func demo() {
        var addressbook = AddressbookMessage(config: MessageConfig())
        addressbook.set_address("138xxxxxxxx")
        addressbook.unsubscribe()
    }
}