Injects the right cordova.js <script> tag for the way your app is currently
running. It is an internal helper for the reco CLI (react.cordova).
You probably don't want to install this directly.
reco initalready adds it to new projects and wires up the import. There is no API, no exports, and no configuration — installing it by hand only makes sense if you are assembling a React + Cordova project withoutreco.
Importing the package registers a load listener that appends a <script> tag
pointing at cordova.js. The only thing it decides is the URL:
| Condition | cordova.js resolved from |
|---|---|
NODE_ENV === "production" |
<PUBLIC_URL>/cordova.js — the copy Cordova itself injects into the packaged app |
| Anything else | http://<host>:8597/browser/www<PUBLIC_URL>/cordova.js — served by cordova serve 8597, which reco start runs for you |
Changed in 1.2.0. The production path used to also require "serviceWorker" in navigator, copied from Create React App's service-worker boilerplate even though this
package registers no service worker. But navigator.serviceWorker is undefined on
file:// and on WKWebView custom-scheme origins — exactly the packaged-app
environments this shim exists for — so those builds silently fell through to the
localhost dev URL and Cordova never loaded. A production build now always takes the
production path.
That is the whole package: about thirty lines, no dependencies, no exports. It also appends an HTML comment to the document body so you can see where the tag came from when reading the DOM.
Import it once, for its side effect, before you mount your app — then wait for
Cordova's deviceready event:
import ReactDOM from "react-dom/client";
import App from "./App";
import "cordova_script"; // side-effect import: injects cordova.js
document.addEventListener(
"deviceready",
() => {
ReactDOM.createRoot(document.getElementById("root")).render(<App />);
},
false
);This is exactly what the reco project template generates.
npm install cordova_scriptExpects a bundler that substitutes process.env.NODE_ENV and process.env.PUBLIC_URL
(Create React App, Webpack, and similar). Port 8597 is hard-coded to match the dev
server reco starts.
ISC © ui-db.com