Repository files navigation

MonkeyKing helps you post SNS messages to Chinese Social Networks, without their buggy SDKs.

MonkeyKing uses the same analysis process ofopenshare.We also use some reverse engineering tools such asHopper Disassembler to unveil several undocumented authentication mechanisms under the hood.It supports sharingText,URL,Image,Audio,Video, andFile toWeChat,QQ,Alipay orWeibo.MonkeyKing can also post messages to Weibo by a web page. (Note: Audio and Video are exclusive to WeChat or QQ, and File is exclusive to QQ Dataline)

MonkeyKing also supportsOAuth andMobile payment via WeChat and Alipay!

Swift 5, iOS 9

(For Swift 4.2, use version 1.13.0)

(For Swift 4.1/4.0, use version 1.11.0)

(For Swift 3, use version 1.3.0)

Example: Share to WeChat (微信)：

1. In your Project Target'sInfo.plist, setURL Type,LSApplicationQueriesSchemes as follow:

   

   You should also addweixinULAPI once you enabled Universal Link of your WeChat App.

2. Register account: // it's not necessary to do it here, but for the sake of convenience

   func application(_ application:UIApplication, didFinishLaunchingWithOptions launchOptions:[UIApplicationLaunchOptionsKey:Any]?)->Bool{MonkeyKing.regsiterAccount(.weChat(            appID:"xxx",            appKey:"yyy",            miniAppID:nil,            universalLink:nil // FIXME: You have to adopt Universal Link otherwise your app name becomes "Unauthorized App"(未验证应用)...))returntrue}

3. Append the following code to handle callbacks:

   // AppDelegate.swiftfunc application(_ app:UIApplication, open url:URL, options:[UIApplicationOpenURLOptionsKey:Any]=[:])->Bool{//func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool { // only for iOS 8returnMonkeyKing.handleOpenURL(url)}

   Remember to handle userActivities if you are usingUIScene in your project:

   // SceneDelegate.swiftfunc scene(_ scene:UIScene, continue userActivity:NSUserActivity){MonkeyKing.handleOpenUserActivity(userActivity)}

4. Prepare your message and ask MonkeyKing to deliver it:

   @IBActionfunc shareURLToWeChatSession(sender:UIButton){MonkeyKing.registerAccount(.weChat(appID:"xxx", appKey:"yyy", miniAppID:nil)) // you can do it here (just before deliver)letmessage=MonkeyKing.Message.weChat(.session(info:(        title:"Session",        description:"Hello Session",        thumbnail:UIImage(named:"rabbit"),        media:.url(URL(string:"http://www.apple.com/cn")!))))MonkeyKing.deliver(message){ successinprint("shareURLToWeChatSession success:\(success)")}}

It's done!

Example: Weibo OAuth

MonkeyKing.oauth(for:.weibo){(oauthInfo, response, error)->Voidinprint("OAuthInfo\(oauthInfo) error\(error)")    // Now, you can use the token to fetch info.}

or, WeChat OAuth for code only

MonkeyKing.weChatOAuthForCode{[weak self](code, error)inguardlet code= codeelse{return}    // TODO: fetch info with code}

If the user doesn't have Weibo App installed on their devices then MonkeyKing will use web OAuth:

Example: Alipay

letorder=MonkeyKing.Order.alipay(urlString: urlString, scheme:nil)MonkeyKing.deliver(order){ resultinprint("result:\(result)")}

You need to configurepay.php in a remote server. You can find an example ofpay.php at the Demo project.

letpath="..."MonkeyKing.launch(.weChat(.miniApp(username:"gh_XXX", path: path, type:.release))){ resultinswitch result{case.success:breakcase.failure(let error):print("error:", error)}}

Note thatusername has agh_ prefix (原始ID).

If you like to useUIActivityViewController for sharing then MonkeyKing hasAnyActivity which can help you.

Check the demo for more information.

github "nixzhu/MonkeyKing"

pod'MonkeyKing'

https://github.com/nixzhu/MonkeyKing

Thanks to all thecontributors.

WeChat logos fromWeChat-Logo by Ray.

MonkeyKing is available under theMIT License. See the LICENSE file for more info.