摘要：介紹暢想是由團隊最新開發維護的一個跨平臺的應用程序容器，可以輕松構建在，，和上本機運行的應用程序。后者旨在替代或者說是進化。希望看到在未來發展，以及正式發布。我認為它有可能大大改善混合應用開發體驗。

  1.介紹or暢想

  Capacitor是由ionic團隊最新開發維護的一個跨平臺的應用程序容器，可以輕松構建在iOS，Android，Electron 和 Web 上本機運行的Web應用程序。我們稱這些應用為“Native Progressive Web Apps”，而我一般喜歡叫做混合移動開發。

   Capacitor是Apache Cordova和Adobe PhoneGap的精神繼承者，Capacitor將自己描述為“a cross-platform API and code execution layer that makes it easy to call Native SDKs from web code and to write custom Native plugins that your app might need”??一個跨平臺的API和代碼執行層，可以輕松地從Web代碼調用Native SDK并編寫您的應用可能需要的自定義Native插件。同時在支持它們的平臺上訪問本機設備功能，適用于iOS上的Swift，Android上的Java和適用于Web的JavaScript的插件API，使開發者可以輕松添加本機功能。

   Capacitor同時還具有出色的易于使用的工具，用于管理構建和部署平臺。從理念上，它與Weex很相近：Write once，run anywhere，這與cordova 形成鮮明的對比。后者旨在替代（或者說是進化）。Capacitor 對許多現有的cordova plugin具有向后兼容的支持，其意圖非常明顯。Ionic作為最流行的混合移動框架，在ionic 123版本中都是運行在Cordova之上，但在4版本中，Capacitor已經成為Ionic應用程序的默認選項，你可以繼續選擇使用cordova或者嘗試使用Capacitor。同時Capacitor還提供兼容層，允許在Capacitor項目中使用現有的Cordova插件。Capacitor具有許多功能，下面將介紹。將來很有可能成為Cordova等或者其他解決方案的良好替代品。除了在Ionic應用程序中使用Capacitor之外，還可以在沒有Ionic的情況下使用Capacitor與你選擇的前端框架或UI庫，例如Angular，Vue，React with Material。。。等等等

   2.安裝+環境配置+項目維護

     最基本要求是Node+，以及NPM 5.6.0+，一般情況下下載node包安裝后自帶安裝了npm的了。

   ios開發

   構建iOS應用程序，首先你要有一臺mac電腦，并且安裝Xcode 9+，官方表示他們很快將你在windows上也可以用ionic pro為ios構建，我猜應該是ionic提供于云打包的功能吧。

首先你要安裝CocoaPods，安裝CocoaPods后，需要更新本地的儲存庫，確保本季具有最新版本的CocoaPods依賴項，所以應該定期運行此命令，更新本機的庫版本。

##安裝cocoapods
sudo gem install cocoapods

##更新本地的儲存庫
pod repo update

如果你在更新本地儲存庫出現以下問題

fatal: 有歧義的參數 HEAD：未知的版本或路徑不存在于工作區中。
使用 -- 來分隔版本和路徑，例如：
git <命令> [<版本>...] -- [<文件>...]
Updating spec repo `master`
fatal: 有歧義的參數 HEAD：未知的版本或路徑不存在于工作區中。
使用 -- 來分隔版本和路徑，例如：
git <命令> [<版本>...] -- [<文件>...]
fatal: 有歧義的參數 HEAD：未知的版本或路徑不存在于工作區中。
使用 -- 來分隔版本和路徑，例如：
git <命令> [<版本>...] -- [<文件>...]
  $ /usr/local/bin/git -C /Users/huangenai/.cocoapods/repos/master fetch origin
  --progress
  remote: Enumerating objects: 127, done.        
  remote: Counting objects: 100% (127/127), done.        
  remote: Compressing objects: 100% (91/91), done.        
  remote: Total 2561792 (delta 55), reused 35 (delta 35), pack-reused 2561665        
  接收對象中: 100% (2561792/2561792), 585.57 MiB | 2.17 MiB/s, 完成.
  處理 delta 中: 100% (1501235/1501235), 完成.
  來自 https://github.com/CocoaPods/Specs
   * [新分支]          backz                 -> origin/backz
   * [新分支]          master                -> origin/master
   * [新分支]          predates_sharding_branch -> origin/predates_sharding_branch
   * [新分支]          swift_version_support -> origin/swift_version_support
   * [新標簽]          v0.32.1               -> v0.32.1
   * [新標簽]                  20161019              -> 20161019
  $ /usr/local/bin/git -C /Users/huangenai/.cocoapods/repos/master rev-parse
  --abbrev-ref HEAD
  fatal: 有歧義的參數 HEAD：未知的版本或路徑不存在于工作區中。
  HEAD
  使用 -- 來分隔版本和路徑，例如：
  git <命令> [<版本>...] -- [<文件>...]
[!] CocoaPods was not able to update the `master` repo. If this is an unexpected issue and persists you can inspect it running `pod repo update --verbose`

請將源地址改為國內的鏡像地址

ps：網上介紹的都是用淘寶的源，一開始我也是設置淘寶的源，一直報錯，Error fetching https://ruby.taobao.org/: bad response Not Found 404 

。原因是中國的ruby鏡像交由社區來維護了，一開始是重定向到http://gems.ruby-china.org/，后來社區域名改了，所以最終ruby的鏡像地址是 這個https://gems.ruby-china.com

//去掉默認更新源
$ gem sources --remove https://rubygems.org/  
//使用國內社區維護的源
$ gem sources -a https://gems.ruby-china.com

安裝xcode 命令行工具

終端運行下面的命令

如果你出現問題無法通過命令安裝 請看這個文章??  Xcode 命令行工具 Command Line Tools

xcode-select --install

最新版本的Capacitor始終支持最后兩個iOS版本。例如，iOS 11和iOS 10.要支持舊版本的iOS，如果你要支持ios9 可能就要使用舊版本的Capacitor了（如果可用）。

android開發

官方要求必須安裝java8 jdk

首先，如果安裝了其他版本的JDK ，則必須安裝Java 8 JDK，Java 9目前無法運行。

Android開發需要安裝Android Studio的Android SDK。Android Studio不是必需的，可以僅使用Android CLI工具構建和運行應用程序，官方覺得android studio使構建和運行應用程序變得容易，所以安裝吧，畢竟有時候 調試的時候還是要用的。目前支持的API等級21+，即Android 5.0+，所以如果要求支持android 4.4的那Capacitor就不適用了。還需要安裝Chrome50+版本的Android WebView。

 安裝使用 Capacitor（多種選擇）

 1.將Capacitor添加到現有的前端項目

cd my-app
npm install --save @capacitor/core @capacitor/cli
npx cap init //會要你輸入應用程序ID，即android 的程序包名或ios的appid 還要輸入項目路徑

 2.創建一個項目

npx @capacitor/cli create

//會要你輸入應用程序ID，即android 的程序包名或ios的appid 還要輸入項目路徑

3.在ionic中使用Capacitor

//新建項目
//適用于1-4版本
ionic start ionicCapatitor tabs

cd ionicCapatitor

npm run build

//安裝capacitor
npm install --save @capacitor/cli @capacitor/core

//capacitor與Cordova的Splashscreen插件沖突，所以要刪掉。
npm uninstall --save cordova-plugin-splashscreen

//Init 應用程序信息
npx cap init [appName] [appId]

//添加平臺
npx cap add ios
npx cap add android

//命令打開對應平臺的IDE進行構建 ios 將會打開xcode android 打開android studio 前提是你已經安裝了。
npx cap open ios
npx cap open android

當項目代碼修改了，要重新構建發布新的版本呢。

//如果在ionic 則 ionic build
npm run build

//復制
npx cap copy

//打開對應平臺的IDE進行構建
npx cap open [ios or android or order]

項目維護

定期更新依賴

npx cap update

3.使用cordova插件

npm install cool-cordova-plugin //插件名稱

npx cap sync //同步

重要提示：

Capacitor不支持Cordova安裝變量，不支持自動配置或。所以如果插件需要設置變量，則需要手動添加。

比如說 極光推送 需要添加APP_KEY的，你需要通過編輯要平臺的本機項目來配置。這意味著你需要去編輯Info.plistiOS AndroidManifest.xml文件和Android文件

 4.使用Capacitor Plugins

  Capacitor提供了一個運行時，使開發人員能夠使用Web的三大支柱 - HTML，CSS和JavaScript - 來構建在Web上以及主要桌面和移動平臺上本機運行的應用程序。但它還提供了一組插件來訪問設備的本機功能，例如相機，而無需為每個平臺使用特定的低級代碼; 該插件為您完成，并為此提供規范化的高級API。Capacitor還提供了一個API，您可以使用該API為Ionic團隊提供的官方插件集未涵蓋的本機功能構建自定義插件。你可以學習如何在文檔中創建插件，還可以在文檔中找到有關可用API和核心插件的更多詳細信息。

Capacitor APIs： https://capacitor.ionicframework.com/docs/apis/

 示例：

home.ts

import { Plugins } from @capacitor/core;

export class HomePage {
  async showDialogAlert() {
    await Plugins.Modals.alert({
      title: Alert,
      message: 彈框測試
    });
  }
}

home.page

效果

5.構建

ios

npx cap add ios 
//在ionic中則
ionic capacitor copy ios

npx cap copy

npx cap open ios

自定義原生iOS代碼

如果現有的無法滿足你的業務需求，沒有適合的Capacitor插件。

優秀的你可以使用Swift 或者Objective-C來構建插件，造福人類。

我之前寫過cordova的插件，原理都差不多都。

android

npx cap add android

//在ionic中則
ionic capacitor copy android

npx cap copy

npx cap open android

同樣你也可以自定義原生的java代碼寫個插件

比如說你要一個功能調用攝像頭，

new 一個 camera.java 繼承 Plugin，

camera.java寫好調用攝像頭的功能，返回結果。

然后在MainActivity中注冊插件即可，跟cordova 差不多的。

我初略看了下原理其實都差不多的

詳細請看這個https://capacitor.ionicframework.com/docs/plugins/

6.配置

在npx cap init [appName] [appId]的時候會創建一個capacitor.config.json文件，因為我們只輸入了 appname跟appid，內容大概如下

{
  "appId": "com.xxx.xxx",
  "appName": "ionic-angular",
  "bundledWebRuntime": false,
  "webDir": "www"
}

更多配置上的 請看官網的配置規范。https://capacitor.ionicframework.com/docs/basics/configuring-your-app

7.Capacitor特點

1.開源和免費

它一個開源項目，根據許可的MIT許可證授權，由Ionic和社區維護

2.跨平臺

構建在iOS，Android，Electron和Progressive Web Apps上運行良好的Web應用程序。

3.對平臺SDK的本機訪問

在每個平臺上可以訪問完整的原生SDK，并輕松地部署到應用程序商店（和網站！）。

4.標準Web和瀏覽器技術

使用Capacitor構建的應用程序使用標準Web API，因此您的應用程序也將是跨瀏覽器的，并且將在遵循該標準的所有現代瀏覽器中良好運行。
5.可擴展
可以通過添加插件來訪問底層平臺的本機功能，或者，如果找不到符合您需求的插件，則可以通過簡單的API創建自定義插件，或使用現有的Cordova插件。

6.簡單
專注于你想做什么，而不是如何做。Capacitor將復雜的專有原生API變成簡單的JS調用。

8.博主思考

 毫無疑問，由ionic tream 開發維護的Capacitor，來勢洶洶，意在要替換掉cordova了。Cordova的團隊已經付出了巨大的工程努力，允許使用它的開發者在每個支持的平臺上管理配置和構建流程，而Capacitor則專注于管理應用程序的Web資產以及它們與目標平臺之間的集成，同時保留了實際上，將應用程序構建和打包到平臺自己的專用工具鏈，無疑更甚一籌。cordova你需要花很多的時間去管理Cordova的config.xml文件，在寫法上如果你用過cordova可能會編寫很多平臺檢查代碼，如下所示：

if（platform.is（cordova））{ 
  cordovaPlugin.doSomething（...）
} else { 
  web.doSomething（...）
}

在Capacitor中，這種類型的代碼將簡化為一行

capacitorPlugin.doSomething（...）

Capacitor提供一致的API，而cordova 可能在不同平臺使用 api是不一樣的。還有可能是因為Cordova對其當前插件的不可靠支持，開發者通常不得不依賴這些第三方開發人員來保持他們的插件是最新的。而且經常這些第三方插件存在著許多bug，需要要花費大量的時間去調試發現bug，和不得不去自己修改插件。ionic trean 自己說了覺得將本機插件和功能的責任推遲到社區已經不夠了。如果想提供客戶期望的服務水平，以及在移動市場中引領的開發者體驗，他們必須承擔這一部分的責任。所以他們在設計capacitor的時候，以支持大多數現有的Cordova插件。ionic tream可以說得上是相當了不起了，感覺他們并不是僅僅說開發一套ui組件。希望看到Capacitor在未來發展，以及ionic4正式發布。Capacitor+ionic4 我認為它有可能大大改善混合應用開發體驗。隨著這項技術的發展，讓開發者專注于開發，而不是項目的構建和部署平臺。期待····

本文純屬個人觀點，如有不妥的，請多多包含。

參考連接

github capacitor

capacttor 官網

https://bendyworks.com/blog/capacitor-elm

https://blog.csdn.net/langyuewu/article/details/79579237

https://www.joshmorony.com/using-cordova-plugins-that-require-install-variables-with-capacitor/

Cordova vs Capacitor（視頻）需要fan qiang - 早期體驗比較

此隨筆乃本人學習工作記錄，如有疑問歡迎在下面評論，轉載請標明出處。

如果對您有幫助請動動鼠標右下方給我來個贊，您的支持是我最大的動力。