主页
Hippy是一个跨平台的开发框架,旨在帮助开发者一次编写,在多个平台(iOS、Android、Web等)上运行。 Hippy 对 Web 开发人员相当友好,尤其是那些熟悉 React 或 Vue 的开发人员。借助 Hippy,开发人员可以轻松创建跨平台应用程序。
目前Hippy已应用于手Q、手Q浏览器、腾讯视频、QQ音乐、腾讯新闻等腾讯各大APP,覆盖数亿普通用户。
React
、 Vue
等Web框架。确保本地安装了 git 和 npm。
运行git clone https://github.com/Tencent/Hippy.git
并在项目根目录下npm install
。
Hippy仓库使用git-lfs来管理so、gz、otf文件,请确保您已经安装了git-lfs。
对于 macOS 开发者:
建议使用 homebrew 安装依赖项。
对于 Windows 开发人员:
Windows目前还不能运行iOS开发环境。
对于 iOS,我们建议首次尝试时使用 iOS 模拟器。但是,如果您是 iOS 专家,则可以更改 Xcode 配置以将应用程序安装到 iPhone。
cd
到driver/js/
。
运行npm run init
。
该命令与
npm install && npx lerna bootstrap && npm run build
结合使用。
npm install
:安装项目构建脚本依赖项。
npx lerna bootstrap
: 安装各个npm包的依赖。(Hippy使用Lerna来管理多个js包,如果没有找到lerna
命令,请先执行npm install lerna -g
。)
npm run build
:构建每个前端 sdk 包。
选择要使用npm run buildexample [hippy-react-demo|hippy-vue-demo|hippy-vue-next-demo]
构建的演示。
使用brew install cocoapods
安装CocoaPods,使用brew install cmake
安装cmake,然后在framework/examples/ios-demo
目录下执行pod install
命令,这将创建HippyDemo.xcworkspace
文件并安装Cocoapods依赖项。
启动 Xcode 并通过打开framework/examples/ios-demo/HippyDemo.xcworkspace
构建 iOS 应用程序。
如果
Step 2
出现错误,您可以cd
到driver/js/examples
hippy-react-demo 或 hippy-vue-demo,然后运行npm install
首先安装演示依赖项。有关 iOS SDK 集成的更多详细信息。
对于Android,我们建议使用真机以获得更好的开发体验,因为Hippy使用的是X5 JS引擎,不支持x86模拟器,而且ARM模拟器性能较低。
在构建 Android 应用程序之前,请确保已安装 SDK 和 NDK,并且不要更新构建工具链。
cd
到driver/js/
。
运行npm run init
。
该命令与
npm install && npx lerna bootstrap && npm run build
结合使用。
npm install
:安装项目构建脚本依赖项。
npx lerna bootstrap
: 安装各个npm包的依赖。(Hippy使用Lerna来管理多个js包,如果没有找到lerna
命令,请先执行npm install lerna -g
。)
npm run build
:构建每个前端 sdk 包。
选择要使用npm run buildexample [hippy-react-demo|hippy-vue-demo|hippy-vue-next-demo]
构建的演示。
使用 Android Studio 打开根目录下的Hippy Project
。
用USB线连接Android手机并确保开启USB调试模式(在电脑端运行adb devices
查看手机连接状态)。
使用Android Studio打开项目,运行并安装apk。
如果
Step 2
出现错误,您可以cd
到driver/js/examples
hippy-react-demo、hippy-vue-demo 或 hippy-vue-next-demo,然后运行npm install
首先安装演示依赖项。如果您遇到
No toolchains found in the NDK toolchains folder for ABI with prefix: mips64el-linux-android
的问题,这里是解决方案。Android SDK 集成的更多详细信息。
cd
到driver/js/
。npm run init:example [hippy-react-demo|hippy-vue-demo|hippy-vue-next-demo]
。npm run debugexample [hippy-react-demo|hippy-vue-demo|hippy-vue-next-demo] dev
。或者您可以
cd
到driver/js/examples/hippy-react-demo
、driver/js/examples/hippy-vue-demo
或driver/js/examples/hippy-vue-next-demo
目录来运行npm run hippy:debug
并npm run hippy:dev
代替。在示例调试模式下,npm 包(例如 @hippy/react、@hippy/vue、@hippy/vue-next)链接到
driver/js/packages
>[different package]
>dist
(不是 node_modules),因此如果您已更改js打包源码,想让其在目标示例中生效,请再次调用npm run build
。有关调试的更多详细信息,请参阅 Hippy 调试文档。
cd
到driver/js/examples/hippy-react-demo
、 driver/js/examples/hippy-vue-demo
或driver/js/examples/hippy-vue-next-demo
。npm install
以安装 demo js 依赖项。npm run hippy:vendor
和npm run hippy:build
来构建生产vendor.[android|ios].js
和index.[android|ios].js
。Hippy 演示使用 DllPlugin 来拆分公共块和应用程序块。
要查看嬉皮士示例并访问 hippyjs.org。
每个发行版本的详细更改记录在项目发行说明中。
Hippy
├── devtools # Devtools for Hippy.
├── dom # DOM Layer for Hippy.
├── driver # Different UI Driver Layers for Hippy.
│ └── js # JS Driver Layer for Hippy.
│ ├── examples # Related examples for JS Driver.
│ ├── include
│ ├── packages # Related JS Packages for JS Driver.
│ │ ├── hippy-react
│ │ ├── hippy-react-web
│ │ ├── hippy-vue
│ │ ├── hippy-vue-css-loader
│ │ ├── hippy-vue-loader
│ │ ├── hippy-vue-native-components
│ │ └── hippy-vue-router
│ └── src
├── framework
│ ├── android
│ ├── examples
│ │ ├── android-demo
│ │ └── ios-demo
│ └── ios
├── layout # Layout engine for Hippy.
├── modules
│ ├── android
│ └── footstone
├── renderer # Different Renderers for Hippy.
│ ├── flutter
│ └── native
│ ├── android
│ └── ios
└── static
欢迎开发者为腾讯开源做出贡献,我们也会给予他们奖励,以表彰和感谢他们。这里我们提供了腾讯开源贡献的官方描述。每个项目的具体贡献规则由项目组制定。开发者可以选择合适的项目并按照相应的规则参与。腾讯项目管理委员会将定期向合格贡献者汇报,并由官方联系人颁发奖励。在向 Hippy 提出拉取请求或问题之前,请务必阅读贡献指南。
所有已经为 Hippy 做出贡献的人都可以在贡献者和作者文件中看到。
Hippy 已获得 Apache-2.0 许可。
嬉皮生态系统
Taitank布局引擎