Cordova 12の注意点について

keiji_asial

Cordova

Monaca

Pocket

Monacaチームの小田川です。

MonacaでCordova 12がサポートされました。MonacaプロジェクトのCordova 12へのアップグレード方法やCordova 12の注意点等については、以下を参照してください。

Cordova 12では、複数の基本Cordovaプラグインで不具合が報告されていたり、旧Monacaテンプレートプロジェクトを使用してる場合、動作に問題が発生する場合があります。

今回は、現在、Cordova 12で判明している不具合および対応方法について説明していきたいと思います。

基本Cordovaプラグインの不具合について

現在、以下の基本プラグインでは、Android 13で使用した際に不具合が発生する報告があります。

現在、Monacaでは、不具合に対応するために、不具合改修版のCordovaプラグインを公開しています。不具合改修版のCordovaプラグインの利用方法については、以下を参照していください。

Cordova12 サポートの開始 - Android13でのカメラおよびメディアキャプチャープラグインの不具合とMonacaによる対処法

公式のCordovaプラグイン側で修正版が公開された際には、Monacaで提供している不具合改修版から公式版へ変更してください。

cordova-plugin-statusbar@3.0.0以降について

cordova-plugin-statusbar@3.0.0からの仕様変更により、Android用ストア版MonacaデバッガーおよびAndroid用カスタムビルドデバッガーでcordova-plugin-statusbarをサポートすることが困難となったため、cordova-plugin-statusbarは、非搭載となりました。そのため、Monacaデバッガーでcordova-plugin-statusbarの機能を実行した場合、エラーが発生します。

エラーを回避する場合は、以下のようにソースコード上でcordova-plugin-statusbarが提供している「StatusBar」オブジェクトをチェックする必要があります。

// cordova-plugin-statusbarのエラー回避例：
if (typeof(StatusBar) !== 'undefined') {
  console.log("cordova-plugin-statusbar is ready.");
}

webpack 4系について

MonacaクラウドIDEのCordova 12環境で使用されているターミナルでは、node 18系が設定されています。

Cordova 10で提供されていたMonacaテンプレートプロジェクトの中で、トランスパイルを実行するAngular、Reacr、Vue用プロジェクトでは、webpack 4系が使用されています。node 18系の環境でwebpack 4系を使用した場合、トランスパイルに問題が発生します。この問題に対応するには、webpack 4系からwebpack 5系に変更する必要があります。

webpack 4系からwebpack 5系に変更する場合は、以下のファイルを変更する必要があります。

package.json
postcss.config.js
webpack.config.js

Angularのwebpack 5系対応

postcss.config.js、webpack.config.jsについては、以下のファイルをダウンロードして置き換えてください。

package.jsonについては、dependenciesに設定されている

ngx-onsenui
onsenui

のバージョンを以下に変更します。

"ngx-onsenui": "^7.0.0",
"onsenui": "2.11.2",

現在設定されているdevDependenciesの内容を以下に置き換えます。

"devDependencies": {
  "cordova": "^12.0.0",
  "css-loader": "^6.6.0",
  "cssnano": "^5.1.0",
  "file-loader": "^6.2.0",
  "html-loader": "^0.5.5",
  "html-webpack-plugin": "^5.5.0",
  "json-loader": "^0.5.7",
  "mini-css-extract-plugin": "^2.5.3",
  "postcss": "^8.4.7",
  "postcss-loader": "^6.2.1",
  "postcss-preset-env": "^7.4.1",
  "postcss-url": "^10.1.3",
  "progress-bar-webpack-plugin": "^2.1.0",
  "style-loader": "^3.3.1",
  "ts-loader": "^9.2.7",
  "typescript": "^4.6.2",
  "webpack": "^5.69.1",
  "webpack-cli": "^4.9.2",
  "webpack-dev-server": "^4.7.4",
  "yargs": "^17.3.1"
}

scriptsに設定されているdevを以下に変更します。

"dev": "webpack serve --open",

ファイルの編集が完了したらプロジェクトの再構成を実行します。プロジェクトの再構成については、以下を参照してください。

MonacaクラウドIDEのオプション機能について - プロジェクトの再構成

注意点として、ユーザ側でdevDependenciesにパッケージをインストールしている場合は、プロジェクトの再構成後にインストールし直す必要があります。

Reactのwebpack 5系対応

postcss.config.js、webpack.config.jsについては、以下のファイルをダウンロードして置き換えてください。

package.jsonについては、dependenciesに設定されている

onsenui
react
react-dom
react-onsenui

のバージョンを以下に変更します。

"onsenui": "2.11.2",
"react": "^16.8.6",
"react-dom": "^16.4.1",
"react-onsenui": "1.11.4"

現在設定されているdevDependenciesの内容を以下に置き換えます。

"devDependencies": {
  "@babel/core": "^7.17.5",
  "@babel/preset-env": "^7.16.11",
  "@babel/preset-react": "^7.16.7",
  "babel-core": "^6.26.3",
  "babel-loader": "^8.2.3",
  "babel-preset-env": "^1.7.0",
  "babel-preset-react": "^6.24.1",
  "cordova": "^12.0.0",
  "css-loader": "^6.6.0",
  "cssnano": "^5.1.0",
  "file-loader": "^6.2.0",
  "html-loader": "^3.1.0",
  "html-webpack-plugin": "^5.5.0",
  "mini-css-extract-plugin": "^2.5.3",
  "postcss": "^8.4.7",
  "postcss-loader": "^6.2.1",
  "postcss-preset-env": "^7.4.1",
  "postcss-url": "^10.1.3",
  "progress-bar-webpack-plugin": "^2.1.0",
  "react-hot-loader": "^4.13.0",
  "style-loader": "^3.3.1",
  "webpack": "^5.69.1",
  "webpack-cli": "^4.9.2",
  "webpack-dev-server": "^4.7.4",
  "yargs": "^17.3.1"
}

scriptsに設定されているdevを以下に変更します。

"dev": "webpack serve --open",

ファイルの編集が完了したらプロジェクトの再構成を実行します。プロジェクトの再構成については、以下を参照してください。

MonacaクラウドIDEのオプション機能について - プロジェクトの再構成

Vueのwebpack 5系対応

postcss.config.js、webpack.config.jsについては、以下のファイルをダウンロードして置き換えてください。

package.jsonについては、dependenciesに設定されている

onsenui
vue
vue-onsenui

のバージョンを以下に変更します。

"onsenui": "2.11.2",
"vue": "2.6.14",
"vue-onsenui": "2.6.4"

現在設定されているdevDependenciesの内容を以下に置き換えます。

"devDependencies": {
  "@babel/core": "^7.17.5",
  "@babel/preset-env": "^7.16.11",
  "babel-core": "^6.26.3",
  "babel-loader": "^8.2.3",
  "babel-preset-env": "^1.7.0",
  "cordova": "^12.0.0",
  "css-loader": "^6.6.0",
  "cssnano": "^5.1.0",
  "file-loader": "^6.2.0",
  "html-loader": "^3.1.0",
  "html-webpack-plugin": "^5.5.0",
  "mini-css-extract-plugin": "^2.5.3",
  "postcss": "^8.4.7",
  "postcss-loader": "^6.2.1",
  "postcss-preset-env": "^7.4.1",
  "postcss-url": "^10.1.3",
  "progress-bar-webpack-plugin": "^2.1.0",
  "style-loader": "^3.3.1",
  "vue-loader": "15.9.8",
  "vue-template-compiler": "2.6.14",
  "webpack": "^5.69.1",
  "webpack-cli": "^4.9.2",
  "webpack-dev-server": "^4.7.4",
  "yargs": "^17.3.1"
}