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 prp位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.構建

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/

5.配置

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

{
  "appId": "com.shanghaifengze.app.tenant.xtd.official",
  "appName": "ionic-angular",
  "bundledWebRuntime": false,
  "webDir": "www"
}

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

6.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呼叫。

7.博主思考

 毫無疑問，由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 - 早期體驗比較

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

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