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

About the developer

Tencent
6.1K Stars 683 Forks Apache License 2.0 893 Commits 41 Opened issues

Description

Hippy is designed for Web developer to easily build cross-platform and high-performance awesome apps. 👏

Services available

!
?

Need anything else?

Contributors list

Hippy Cross Platform Framework

Hippy Group license PRs Welcome node Actions Status Codecov GitHub release (latest SemVer)

English | 简体中文 | Homepage

💡 Introduction

Hippy is a cross-platform development framework, aiming to help developers write once, run on three platforms(iOS, Android and Web). Hippy is quite friendly to Web developers, especially who are familiar with React or Vue. With Hippy, developers are able to create the cross platform app easily.

Hippy is now applied in 27+ Tencent apps such as Mobile QQ, Mobile QQ Browser, Tencent Video App, QQ Music App, Tencent News, reaching hundreds of millions of ordinary users.

💯 Advantages

  • Designed for Web developers, officially support Web frameworks like
    React
    and
    Vue
    .
  • Same APIs for different platforms.
  • Excellent performance with JS engine binding communication.
  • Build-in recyclable component with better performance.
  • Smoothly and gracefully migrate to Web browser.
  • Fully supported Flex Layout engine.

🔨 Getting started

Preparing environment

Run

git clone https://github.com/Tencent/Hippy.git

Hippy repository applies git-lfs to manage so,gz,otf,png,jpg files, make sure you have installed git-lfs first.

For macOS developers:

homebrew is recommended to install the dependencies.

For Windows developers:

Windows can't run the iOS development environment so far.

Build the iOS simulator with js demo

For iOS, we recommend to use iOS simulator when first try. However, you can change the Xcode configuration to install the app to iPhone if you are an iOS expert.

  1. Install the project build scripts dependencies at root directory with
    npm install
    .
  2. Install dependencies of each npm package at root directory with
    lerna bootstrap
    . (Hippy uses Lerna to manage multi js packages, if
    lerna
    command is not found, execute
    npm install lerna -g
    first.)
  3. Build each front-end sdk package at root directory with
    npm run build
    .
  4. Choose a demo to build with
    npm run buildexample -- [hippy-react-demo|hippy-vue-demo]
    at root directory.
  5. Start the Xcode and build the iOS app with
    open examples/ios-demo/HippyDemo.xcodeproj
    .

If

Step 4
throw error, you can
cd
to
examples
hippy-react-demo or hippy-vue-demo, and run
npm install --legacy-peer-deps
to install demo dependencies first.

More details for iOS SDK integration.

Build the Android app with js demo

For Android, we recommend using the real cellphone for better develop experience, because Hippy is using X5 JS engine which can't support x86 simulator, as well as ARM simulator has a low performance.

Before build the android app, please make sure the SDK and NDK is installed, And DO NOT update the build toolchain.

  1. Install the whole project dependencies at root directory with
    npm install
    .
  2. Install dependencies of each npm package at root directory with
    lerna bootstrap
    . (Hippy uses Lerna to manage multi js packages, if
    lerna
    command is not found, execute
    npm install lerna -g
    first.)
  3. Build each front-end sdk package at root directory with
    npm run build
    .
  4. Choose a demo to build with
    npm run buildexample -- [hippy-react-demo|hippy-vue-demo]
    at root directory.
  5. Open the
    examples/android-demo
    with Android Studio.
  6. Connect Android phone with USB cable and make sure USB debugging mode is enabled(Run
    adb devices
    on the computer terminal to check cellphone connection status).
  7. Open the project with Android Studio, run and install the apk.

If

Step 4
throw error, you can
cd
to
examples
hippy-react-demo or hippy-vue-demo, and run
npm install --legacy-peer-deps
to install demo dependencies first.

If you encounter the issue of

No toolchains found in the NDK toolchains folder for ABI with prefix: mips64el-linux-android
, here is the solution.

More details for Android SDK integration.

Debug the js demo

  1. Follow Build the iOS simulator with js demo or Build the Android app with js demo first to build the App.
  2. cd
    to
    examples
    hippy-react-demo or hippy-vue-demo.
  3. Run
    npm install
    to install demo js dependencies.
  4. Run
    npm run hippy:dev
    and
    npm run hippy:debug
    (
    npm run hippy:local-debug
    will link to source code in packages) respectively to start the live debug mode.

On example debug mode, npm packages such as @hippy/react, @hippy/vue are linked to

packages
>
[different package]
>
dist
(not node_modules), so if you have changed js package source code and want to make it take effect in target example, please call
npm run build
at root directory again.

More details for debugging can be read in Hippy Debug Document.

📁 Documentation

To check out hippy examples and visit hippyjs.org.

📅 Changelog

Detailed changes for each release version are documented in the project release notes.

🧱 Project structure

Hippy
├── examples                          # Demo code for frontend or native developer.
│   ├── hippy-react-demo              # hippy-react js demo code.
│   ├── hippy-vue-demo                # hippy-vue js demo code.
│   ├── ios-demo                      # iOS native demo code.
│   └── android-demo                  # Android native demo code.
├── packages                          # npm packages.
│   ├── hippy-debug-server            # Debug the Hippy with native.
│   ├── hippy-react                   # React binding for Hippy.
│   ├── hippy-react-web               # Web adapter for hippy-react.
│   ├── hippy-vue                     # Vue binding for Hippy.
│   ├── hippy-vue-css-loader          # Webpack loader for convert CSS text to JS AST.
│   ├── hippy-vue-native-components   # Native components extensions for hippy-vue.
│   ├── hippy-vue-router              # Vue router for hippy-vue.
│   └── types                         # Global type definition.
├── ios
│   └── sdk                           # iOS SDK
├── android
│   ├── support_ui                    # Android native components.
│   └── sdk                           # Android SDK.
├── core                              # JS modules implemented by C++, binding to JS engine.
├── docker                            # Native release docker image and build scripts.
├── layout                            # Hippy layout engine.
└── scripts                           # Project build script.

🤝 Contribution

Developers are welcome to contribute to Tencent's open source, and we will also give them incentives to acknowledge and thank them. Here we provide an official description of Tencent's open source contribution. Specific contribution rules for each project are formulated by the project team. Developers can choose the appropriate project and participate according to the corresponding rules. The Tencent Project Management Committee will report regularly to qualified contributors and awards will be issued by the official contact. Before making a pull request or issue to Hippy, please make sure to read Contributing Guide.

All the people who already contributed to Hippy can be seen in Contributors and Authors File.

❤️ Stargazers over time

Stargazers over time

📄 License

Hippy is Apache-2.0 licensed.

🔗 Links

Hippy Eco-System

Taitank Layout Engine

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.