Need help with MonkeyKing?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

nixzhu
2.7K Stars 240 Forks MIT License 483 Commits 14 Opened issues

Description

MonkeyKing helps you to post messages to Chinese Social Networks.

Services available

!
?

Need anything else?

Contributors list

# 5,225
Swift
Objecti...
qq
alipay
160 commits
# 46,108
Swift
uipagev...
uitabba...
qq
118 commits
# 55,896
Swift
Objecti...
image-p...
kingfis...
42 commits
# 7,301
Swift
Objecti...
maxmind
alfred
21 commits
# 32,148
Swift
image-p...
kingfis...
Markdow...
15 commits
# 131,165
Swift
qq
alipay
PHP
15 commits
# 99,822
Objecti...
uiwebvi...
Swift
threads...
6 commits
# 103,835
Swift
CSS
qq
alipay
6 commits
# 79,867
logging...
qq
alipay
swift5
5 commits
# 57,980
Objecti...
Dart
batch
qq
5 commits
# 186,899
React
scrollb...
Swift
Objecti...
4 commits
# 73,624
Swift
CSS
qq
alipay
3 commits
# 264,882
C
C++
qq
alipay
2 commits
# 271,423
qq
alipay
Swift
PHP
2 commits
# 67,743
Java
Groovy
qq
alipay
1 commit
# 117,596
HTML
PHP
qq
alipay
1 commit
# 207,877
qq
alipay
Swift
Objecti...
1 commit
# 37,722
Swift
font-ic...
uicontr...
swift-3
1 commit
# 343,488
qq
alipay
PHP
weibo
1 commit
# 114,738
C
CSS
qq
alipay
1 commit

MonkeyKing

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

MonkeyKing uses the same analysis process of openshare. We also use some reverse engineering tools such as Hopper Disassembler to unveil several undocumented authentication mechanisms under the hood. It supports sharing Text, URL, Image, Audio, Video, and File to WeChat, QQ, Alipay or Weibo. 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 supports OAuth and Mobile payment via WeChat and Alipay!

Requirements

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)

Examples

Share

Example: Share to WeChat (微信):

  1. In your Project Target's

    Info.plist
    , set
    URL Type
    ,
    LSApplicationQueriesSchemes
    as follow:

    You should also add

    weixinULAPI
    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"(未验证应用)...
            )
        )
        return true
    }
    
  3. Append the following code to handle callbacks:

    // AppDelegate.swift
    
    

    func 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 8 return MonkeyKing.handleOpenURL(url) }

    Remember to handle userActivities if you are using

    UIScene
    in your project: ```swift // SceneDelegate.swift

    func scene(_ scene: UIScene, continue userActivity: NSUserActivity) { MonkeyKing.handleOpenUserActivity(userActivity) } ```

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

    @IBAction func shareURLToWeChatSession(sender: UIButton) {
    
    
    MonkeyKing.registerAccount(.weChat(appID: "xxx", appKey: "yyy", miniAppID: nil)) // you can do it here (just before deliver)
    
    let message = 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) { success in
        print("shareURLToWeChatSession success: \(success)")
    }

    }

It's done!

OAuth

Example: Weibo OAuth

MonkeyKing.oauth(for: .weibo) { (oauthInfo, response, error) -> Void in
    print("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) in
    guard let code = code else {
        return
    }
    // TODO: fetch info with code
}

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

Pay

Example: Alipay

let order = MonkeyKing.Order.alipay(urlString: urlString, scheme: nil)
MonkeyKing.deliver(order) { result in
    print("result: \(result)")
}

You need to configure

pay.php
in a remote server. You can find an example of
pay.php
at the Demo project.


Launch WeChat Mini App

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

Note that

username
has a
gh_
prefix (原始ID).

More

If you like to use

UIActivityViewController
for sharing then MonkeyKing has
AnyActivity
which can help you.

Check the demo for more information.

Installation

Carthage

github "nixzhu/MonkeyKing"

CocoaPods

pod 'MonkeyKing'

Swift Package Manager

https://github.com/nixzhu/MonkeyKing

Contributors

Thanks to all the contributors.

Credits

WeChat logos from WeChat-Logo by Ray.

License

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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.