首頁
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 install lerna -g
套件的依賴lerna
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 install lerna -g
套件的依賴lerna
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佈局引擎