1. 為什么適配JS開源庫

由于OpenHarmony應用是基于ArkTS開發(fā)，而ArkTS是在保持TypeScript（簡稱TS）基礎語法風格的基礎上，對TS的動態(tài)類型特性施加更嚴格的約束，引入靜態(tài)類型。因此在開發(fā)OpenHarmony三方庫時，建議首選在成熟的JS/TS開源三方庫上開發(fā)。

2. 選擇哪個JS開源庫合適

JS/TS開源三方庫的選擇需遵循易用性、實用性、維護性、擴展性等特性，通常方法是在github/npm上按照特性和語言搜索，找到star、fork數(shù)量較高的，且開源協(xié)議友好的JS/TS開源三方庫進行適配。

3. 如何進行JS開源庫適配

由于OpenHarmony開發(fā)框架中的API不完全兼容V8運行時的Build-In API，因此建議在適配JS三方庫前，使用[js-e2e]掃描三方庫，檢查是否存在node.js/web內(nèi)置模塊的依賴。

js-e2e工具時基于eslint進行封裝，可分析出JS庫代碼對node.js/web瀏覽器的內(nèi)置模塊、對象的依賴及兼容ES標準版本，使用該工具，可以快速知道該庫是否依賴node.js/web內(nèi)置模塊。

如果掃描結果不依賴node.js/web內(nèi)置模塊，那么，這個庫將比較輕松地適配。如果大量依賴node.js/web內(nèi)置組件，這時可能需要fork源庫代碼，進行侵入式修改，或者再找是否存在更適合的其他三方庫。

注：掃描時需同時掃描package.json文件中dependencies標簽中直接依賴和間接依賴，因為發(fā)布OpenHarmony三方庫中心倉時，需要將依賴的組件都發(fā)布。建議使用npm insall下載所有依賴的代碼后，一起掃描查看結果。

3.1 luxon開源庫信息

在npm中心倉庫查看用于處理日期和時間的目標庫luxon信息，包括開源倉庫地址，主頁地址，版本，協(xié)議，文件大小，總文件數(shù)，最后發(fā)布時間等。

在OpenHarmony中心倉搜索是否存在luxon目標庫。

在luxon源代碼倉庫查看star和fork數(shù)量，查看是否被經(jīng)常使用和經(jīng)常被維護。

luxon倉庫：https://github.com/moment/luxon

3.2 JS三方庫掃描工具介紹

js-e2e是基于eslint進行封裝、配置規(guī)則，用于分析JS庫代碼對NodeJS和Web瀏覽器的內(nèi)置模塊、對象的依賴及兼容ES標準版本的工具，支持檢查指定源碼目錄和指定三方庫的兼容性。

3.2.1 使用git工具同步js-e2e代碼

3.2.2 安裝npm依賴包

3.2.3 安裝自定義的eslint輸出報告formatter，包含csv、csvsimple、vscode、vscodesimple

3.2.4 執(zhí)行檢查命令

3.3 適配luxon三方庫

1. 使用DevEco Studio開發(fā)者工具，創(chuàng)建OpenHarmony應用工程。

2. 在工程中新建Module，選擇“Static Library”模板。

3. 移除library模塊src/main/ets目錄中的components目錄，刪除Index.ets文件中的代碼。
4. 直接復制js-e2e工具檢查時下載的luxon包（temp/node_modules/luxon），并將src目錄中的文件復制到library模塊的src/main/ets/lib目錄下。

5）修改Index.ets文件為其他開發(fā)者提供調(diào)用接口。

6. 在oh-package.json5中完善三方庫信息，如名稱、簡介、版本、開源協(xié)議、作者、關鍵字等。

7. 在工程目錄中選中三方庫名稱，單擊菜單欄中的Build > Make Module ‘library’編譯構建生成三方庫HAR包，HAR包可在模塊下的build目錄下獲取，包格式為*.har。

3.4 驗證luxon三方庫

1. 打開entry/oh-package.json5配置文件，在dependencies標簽中引入luxon三方庫，并單擊Sync Now進行同步。

2. 打開pages/Index.ets頁面文件，引入luxon三方庫并顯示當前日期。

至此，簡單的JS開源三方庫適配OpenHarmony已經(jīng)完成了，下節(jié)我們將推出如何將講解如何進行XTS測試，OpenHarmony三方庫發(fā)布標準，適配的三方庫發(fā)布到OpenHarmony三方庫中心倉以及如何貢獻到OpenHarmony-TPC。
審核編輯 黃宇