by Lucky-Orange

Lucky-Orange / BlackHawk

High performance Cordova compatible javascript-native reflection bridge based on fast and sexy WKWeb...

411 Stars 53 Forks Last release: Not found MIT License 46 Commits 4 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


BlackHawk is a Cordova compatible javascript-native reflection bridge based on fast and sexy WKWebView written in pure Swift, with incredible high performance.

Notice: NOT ready for production

Incredible High Performance

Let's test a shooting game called "萌战姬"





That's tons of progress.

Let's test "萌战姬" on iPhone 4S

  • Device: iPhone 4S



BlackHawk makes "萌战姬" can be played on iPhone 4S now.


Basic Features

BlackHawk is a Cordova like software that provides a javascript to native reflection bridge, written in pure Swift, aimed to provide a modern, hight-performance replacement of Cordova on iOS platform. BlackHawk uses WKWebView in Apple's new WebKit Framework with pure Swift Language.

High Performance

BlackHawk can reduce the cost of RAM and CPU significantly, especially for complicated HTML5 pages.

Cordova Compatible

The ultimate goal of BlackHawk is being a complete replacement of Cordova on iOS platform, so that BlackHawk is fully compatible with Cordova's javascript API.

Check-list of BlackHawk plugins:


  • iOS 8+
  • Xcode 7+ (Swift 2+)


Documentation of Architecture

How to Use

include as sub project

Drag BlackHawk/BlackHawk.xcodeproj into your project as a sub project.

copy files


directory to your project, and add it to
Build Phases
Copy Bundle Resources


write some code

In anywhere you want to show a BlackHawk View Controller:

import UIKit
import BlackHawk

class ViewController: BlackHawkViewController {

... ...

run on devices

If you want to run your project on a device, just do one thing:


That's it!

What can BlackHawk be?

BlackHawk is cordova compatible, actually it's a javascript-native reflection bridge, cordova compatible layer is just one of many layers on it.

Obviously you can build your own layer based on your own protocol. Maybe next killer Hybrid Development Framework will be made by you!

Make a plugin for BlackHawk

If you want to build a plugin named

, you need to do 3 steps to make your plugin run:
  1. new a javascript file named
  2. add
    to the params of self.runPluginJS(["Base"]) in BlackHawkViewController class.
  3. do everything you want in

    , new a Swift file or not depends on you. If you want, just see:
    // js code
    Queue.push(Task.init(Queue.length, onSuccess, onError));
        className: 'NothingClassName',
        functionName: 'functionName',
        taskId: Queue.length - 1,
        data: 'nothing'


If you have any suggestions please open an issue, and you are very welcome to fork and submit pull requests.

Plugins for BlackHawk will be best news!


BlackHawk is open-sourced software licensed under the MIT license.

Copyright (c) 2015 Leqicheng Inc. 乐其橙科技(北京)有限公司

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.