feat!: Capacitor 8 upgrade (#295)

trevor-lambert · web-flow · commit 36580157ce76 · 2026-03-09T14:17:07.000-05:00
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -18,16 +18,13 @@ jobs:
         uses: styfle/cancel-workflow-action@ce177499ccf9fd2aded3b0426c97e5434c2e8a73
         with:
           access_token: ${{ secrets.GITHUB_TOKEN }}
+      - uses: actions/checkout@v6
       - name: Get Latest
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v6
         with:
-          node-version: 14.x
-      - uses: actions/checkout@v2
-      - name: Restore Dependency Cache
-        uses: actions/cache@v1
-        with:
-          path: ~/.npm
-          key: ${{ runner.OS }}-dependency-cache-${{ hashFiles('**/package.json') }}
+          node-version: 22
+          cache: npm
+          cache-dependency-path: '**/package-lock.json'
       - name: Get Package Version
         id: package-version
         uses: martinbeentjes/npm-get-version-action@master
@@ -39,15 +36,12 @@ jobs:
     needs:
       - setup
     steps:
-      - uses: actions/setup-node@v1
-        with:
-          node-version: 16.x
-      - uses: actions/checkout@v2
-      - name: Restore Dependency Cache
-        uses: actions/cache@v1
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
-          path: ~/.npm
-          key: ${{ runner.OS }}-dependency-cache-${{ hashFiles('**/package.json') }}
+          node-version: 22
+          cache: npm
+          cache-dependency-path: '**/package-lock.json'
       - run: npm install
         working-directory: plugin
       - run: npm run build
diff --git a/.github/workflows/docs-preview.yml b/.github/workflows/docs-preview.yml
@@ -26,17 +26,17 @@ jobs:
       name: preview-${{ github.event.number }}
       url: https://${{ env.SLUG }}.ionicpreview.com
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
-          node-version: 18
+          node-version: 22
           cache: npm
-          cache-dependency-path: website/package-lock.json
+          cache-dependency-path: '**/package-lock.json'
       - name: Build
         run: |
           npm ci
           npm run build
-      - uses: aws-actions/configure-aws-credentials@v1
+      - uses: aws-actions/configure-aws-credentials@v6
         with:
           role-to-assume: arn:aws:iam::319312831725:role/github-docs
           aws-region: us-east-1
diff --git a/.github/workflows/docs-production.yml b/.github/workflows/docs-production.yml
@@ -28,17 +28,17 @@ jobs:
       name: production
       url: https://ionic.io/docs/${{ env.SLUG }}
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
-          node-version: 18
+          node-version: 22
           cache: npm
-          cache-dependency-path: website/package-lock.json
+          cache-dependency-path: '**/package-lock.json'
       - name: Build
         run: |
           npm ci
           npm run build
-      - uses: aws-actions/configure-aws-credentials@v1
+      - uses: aws-actions/configure-aws-credentials@v6
         with:
           role-to-assume: arn:aws:iam::319312831725:role/github-docs
           aws-region: us-east-1
diff --git a/.github/workflows/pre-release.yml b/.github/workflows/pre-release.yml
@@ -9,10 +9,10 @@ jobs:
   increment-version:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v2
-    - uses: actions/setup-node@v1
+    - uses: actions/checkout@v6
+    - uses: actions/setup-node@v6
       with:
-        node-version: 16.x
+        node-version: 22
     - name: Assign version to RELEASE_VERSION environment variable
       run: echo "RELEASE_VERSION=${GITHUB_REF#refs/*/*/}" >> $GITHUB_ENV
     - name: Bump npm package version
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -9,10 +9,10 @@ jobs:
   publish-to-npm:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v2
-    - uses: actions/setup-node@v1
+    - uses: actions/checkout@v6
+    - uses: actions/setup-node@v6
       with:
-        node-version: 16.x
+        node-version: 22
     - name: Publish package
       run: |
         echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > .npmrc
diff --git a/lerna.json b/lerna.json
@@ -1,12 +1,12 @@
 {
-  "capacitorVersion": "7.0.0",
-  "iosMinVersion": "14.0",
-  "androidMinSdk": "23",
+  "capacitorVersion": "8.0.0",
+  "iosMinVersion": "15.0",
+  "androidMinSdk": "24",
   "rnMinVersion": "0.75.4",
   "androidLiveUpdatesVersion": "0.5.5",
-  "rnVersion": "0.8.0",
-  "iosVersion": "0.12.0",
-  "androidVersion": "0.12.0",
+  "rnVersion": "0.8.5",
+  "iosVersion": "0.13.0",
+  "androidVersion": "0.13.0",
   "cliVersion": "0.3.1",
-  "version": "0.12.0"
-}
+  "version": "0.13.0"
+}
diff --git a/plugin/.prettierignore b/plugin/.prettierignore
diff --git a/plugin/package.json b/plugin/package.json
@@ -29,30 +29,30 @@
     "lint": "npm run eslint && npm run prettier -- --check",
     "fmt": "npm run eslint -- --fix && npm run prettier -- --write",
     "eslint": "eslint . --ext ts",
-    "prettier": "prettier \"**/*.{css,html,ts,js,java}\"",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
     "docgen": "docgen --api PortalsPlugin --output-readme README.md --output-json dist/docs.json",
-    "build": "npm run clean && tsc && rollup -c rollup.config.js",
+    "build": "npm run clean && tsc && rollup -c rollup.config.mjs",
     "clean": "rimraf ./dist && rimraf ./build && rimraf ./types",
     "watch": "tsc --watch",
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "@capacitor/core": "^7.0.0",
-    "@capacitor/docgen": "^0.0.10",
+    "@capacitor/core": "^8.0.0",
+    "@capacitor/docgen": "^0.3.1",
     "@ionic/eslint-config": "^0.4.0",
-    "@ionic/prettier-config": "^1.0.1",
+    "@ionic/prettier-config": "^4.0.0",
     "@ionic/swiftlint-config": "^2.0.0",
-    "@rollup/plugin-node-resolve": "^13.0.4",
-    "eslint": "^8.57.0",
-    "prettier": "~2.2.0",
-    "prettier-plugin-java": "~1.0.0",
-    "rimraf": "^6.0.1",
-    "rollup": "^2.32.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "eslint": "^8.57.1",
+    "prettier": "^3.6.2",
+    "prettier-plugin-java": "^2.7.7",
+    "rimraf": "^6.1.0",
+    "rollup": "^4.53.2",
     "swiftlint": "^2.0.0",
-    "typescript": "~5.0.2"
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@capacitor/core": ">=7.0.0"
+    "@capacitor/core": ">=8.0.0"
   },
   "prettier": "@ionic/prettier-config",
   "swiftlint": "@ionic/swiftlint-config",
diff --git a/plugin/rollup.config.mjs b/plugin/rollup.config.mjs
@@ -19,7 +19,6 @@ export default {
       file: 'dist/index.js',
       format: 'esm',
       banner,
-      preferConst: true,
       sourcemap: true,
       inlineDynamicImports: true,
     },
diff --git a/scripts/get-latest-capacitor-version.mjs b/scripts/get-latest-capacitor-version.mjs
@@ -15,9 +15,9 @@ const req = https.request(options, res => {
 
   res.on('close', () => {
     const latestVersion = JSON.parse(json)['dist-tags'].latest;
-    const lernaConfig = JSON.parse(fs.readFileSync('./lerna.json', 'utf-8'))
+    const lernaConfig = JSON.parse(fs.readFileSync('../lerna.json', 'utf-8'))
     lernaConfig.capacitorVersion = latestVersion
-    fs.writeFileSync('./lerna.json', JSON.stringify(lernaConfig, null, 2) + '\n')
+    fs.writeFileSync('../lerna.json', JSON.stringify(lernaConfig, null, 2) + '\n')
   })
 })
 
diff --git a/website/docs/for-android/changelog.json b/website/docs/for-android/changelog.json
@@ -1,4 +1,17 @@
 [
+  {
+    "productTitle": "Portals Android",
+    "pageUrl": "https://ionic.io/docs/portals/for-android/changelog",
+    "repo": "ionic-team/ionic-portals-android",
+    "mdBody": "### What's Changed\n* **feat!**: Capacitor 8 upgrade ([#80](https://github.com/ionic-team/ionic-portals-android/pull/80))\n\n",
+    "body": "<h3>What's Changed</h3>\n<ul>\n<li><strong>feat!</strong>: Capacitor 8 upgrade (<a href=\"https://github.com/ionic-team/ionic-portals-android/pull/80\">#80</a>)</li>\n</ul>\n",
+    "name": "0.13.0",
+    "raw_published_at": "2026-03-09T18:32:41Z",
+    "published_at": "March 9 2026",
+    "tag_name": "0.13.0",
+    "type": "minor",
+    "version": "0.13.0"
+  },
   {
     "productTitle": "Portals Android",
     "pageUrl": "https://ionic.io/docs/portals/for-android/changelog",
diff --git a/website/docs/for-android/upgrade-guides.md b/website/docs/for-android/upgrade-guides.md
@@ -9,6 +9,16 @@ import CodeBlock from '@theme/CodeBlock';
 
 If you need help configuring specific versions of Portals with Capacitor or Capacitor Plugins, check out our [SDK Version Compatibility](./version-matrix.md) page.
 
+## Portals for Android 0.12.0 → 0.13.0
+
+- Portals for Android version `0.13.0` is compatible with Portals Web Plugin version `0.13.x`.
+
+:::caution
+Portals 0.13.0 is a notable update that upgrades the Capacitor dependency to version 8. Care should be taken to update dependencies across your web content and native apps to ensure compatibility.
+:::
+
+First review the [Capacitor 8 Update Guide](https://capacitorjs.com/docs/updating/8-0#android) for an overview of necessary changes. Some will not be relevant for Portals apps, but this will be a useful reference in case you encounter issues with your upgrade.
+
 ## Portals for Android 0.10.0 → 0.12.0
 
 - Portals for Android version `0.12.0` is compatible with Portals Web Plugin version `0.12.x`.
diff --git a/website/docs/for-android/version-matrix.md b/website/docs/for-android/version-matrix.md
@@ -76,6 +76,7 @@ For more information refer to the Gradle documentation pages:
 
 | Android SDK | Web Plugin Version | Compiled Capacitor Version | Compatible Capacitor Versions | Compatible Live Updates Versions | Portals CLI |
 | :---------: | :----------------: | :------------------------: | :---------------------------: | :------------------------------: | :---------: |
+|   0.13.0    |       0.13.0       |           8.0.+            |             8.0.+             |              0.5.+               |    0.3.+    |
 |   0.12.0    |       0.12.0       |           7.0.+            |             7.0.+             |              0.5.+               |    0.3.+    |
 |   0.10.3    |       0.10.0       |           6.+              |             6.+               |              0.5.+               |    0.3.+    |
 |   0.10.2    |       0.10.0       |           6.0.+            |             6.0.+             |              0.5.+               |    0.3.+    |
diff --git a/website/docs/for-ios/changelog.json b/website/docs/for-ios/changelog.json
@@ -1,4 +1,17 @@
 [
+  {
+    "productTitle": "Portals iOS",
+    "pageUrl": "https://ionic.io/docs/portals/for-ios/changelog",
+    "repo": "ionic-team/ionic-portals-ios",
+    "mdBody": "### What's Changed\n* **feat!**: Capacitor 8 upgrade ([#92](https://github.com/ionic-team/ionic-portals-ios/pull/92))\n\n",
+    "body": "<h3>What's Changed</h3>\n<ul>\n<li><strong>feat!</strong>: Capacitor 8 upgrade (<a href=\"https://github.com/ionic-team/ionic-portals-ios/pull/92\">#92</a>)</li>\n</ul>\n",
+    "name": "0.13.0",
+    "raw_published_at": "2026-03-09T18:55:20Z",
+    "published_at": "March 9 2026",
+    "tag_name": "0.13.0",
+    "type": "minor",
+    "version": "0.13.0"
+  },
   {
     "productTitle": "Portals iOS",
     "pageUrl": "https://ionic.io/docs/portals/for-ios/changelog",
diff --git a/website/docs/for-ios/upgrade-guides.md b/website/docs/for-ios/upgrade-guides.md
@@ -6,6 +6,16 @@ sidebar_label: Upgrade Guides
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
+## Portals for iOS 0.12.x → 0.13.0
+
+- Portals for iOS version `0.13.0` is compatible with Portals Web Plugin version `0.13.x`.
+
+:::caution
+Portals 0.13.0 is a notable update that upgrades the Capacitor dependency to version 8. Care should be taken to update dependencies across your web content and native apps to ensure compatibility.
+:::
+
+First review the [Capacitor 8 Update Guide](https://capacitorjs.com/docs/updating/8-0#ios) for an overview of necessary changes. Some will not be relevant for Portals apps, but this will be a useful reference in case you encounter issues with your upgrade.
+
 ## Portals for iOS 0.11.x → 0.12.0
 
 - Portals for iOS version `0.12.0` is compatible with Portals Web Plugin version `0.12.x`.
diff --git a/website/docs/for-react-native/changelog.json b/website/docs/for-react-native/changelog.json
@@ -1,4 +1,69 @@
 [
+  {
+    "productTitle": "Portals React Native",
+    "pageUrl": "https://ionic.io/docs/portals/for-react-native/changelog",
+    "repo": "ionic-team/ionic-portals-react-native",
+    "mdBody": "### What's Changed\n* **fix(ci)**: add prepack script to fix empty publish artifacts ([#73](https://github.com/ionic-team/ionic-portals-react-native/pull/73))\n\n\n",
+    "body": "<h3>What's Changed</h3>\n<ul>\n<li><strong>fix(ci)</strong>: add prepack script to fix empty publish artifacts (<a href=\"https://github.com/ionic-team/ionic-portals-react-native/pull/73\">#73</a>)</li>\n</ul>\n",
+    "name": "0.8.5",
+    "raw_published_at": "2026-01-14T06:41:56Z",
+    "published_at": "January 14 2026",
+    "tag_name": "0.8.5",
+    "type": "patch",
+    "version": "0.8.5"
+  },
+  {
+    "productTitle": "Portals React Native",
+    "pageUrl": "https://ionic.io/docs/portals/for-react-native/changelog",
+    "repo": "ionic-team/ionic-portals-react-native",
+    "mdBody": "### What's Changed\n* **feat**: add webContentsDebuggingEnabled to PortalView ([#71](https://github.com/ionic-team/ionic-portals-react-native/pull/71))\n\n\n",
+    "body": "<h3>What's Changed</h3>\n<ul>\n<li><strong>feat</strong>: add webContentsDebuggingEnabled to PortalView (<a href=\"https://github.com/ionic-team/ionic-portals-react-native/pull/71\">#71</a>)</li>\n</ul>\n",
+    "name": "0.8.4",
+    "raw_published_at": "2026-01-10T21:35:44Z",
+    "published_at": "January 10 2026",
+    "tag_name": "0.8.4",
+    "type": "patch",
+    "version": "0.8.4"
+  },
+  {
+    "productTitle": "Portals React Native",
+    "pageUrl": "https://ionic.io/docs/portals/for-react-native/changelog",
+    "repo": "ionic-team/ionic-portals-react-native",
+    "mdBody": "### What's Changed\n* **fix**: update null-safety and array processing, bump version to 0.8.3 ([#69](https://github.com/ionic-team/ionic-portals-react-native/pull/69))\n\n\n",
+    "body": "<h3>What's Changed</h3>\n<ul>\n<li><strong>fix</strong>: update null-safety and array processing, bump version to 0.8.3 (<a href=\"https://github.com/ionic-team/ionic-portals-react-native/pull/69\">#69</a>)</li>\n</ul>\n",
+    "name": "0.8.3",
+    "raw_published_at": "2025-09-25T20:10:40Z",
+    "published_at": "September 25 2025",
+    "tag_name": "0.8.3",
+    "type": "patch",
+    "version": "0.8.3"
+  },
+  {
+    "productTitle": "Portals React Native",
+    "pageUrl": "https://ionic.io/docs/portals/for-react-native/changelog",
+    "repo": "ionic-team/ionic-portals-react-native",
+    "mdBody": "### What's Changed\n* **fix(android)**: removing mass unsubscribe in removeListeners ([#64](https://github.com/ionic-team/ionic-portals-react-native/pull/64))\n\n\n",
+    "body": "<h3>What's Changed</h3>\n<ul>\n<li><strong>fix(android)</strong>: removing mass unsubscribe in removeListeners (<a href=\"https://github.com/ionic-team/ionic-portals-react-native/pull/64\">#64</a>)</li>\n</ul>\n",
+    "name": "0.8.2",
+    "raw_published_at": "2025-08-19T21:39:27Z",
+    "published_at": "August 19 2025",
+    "tag_name": "0.8.2",
+    "type": "patch",
+    "version": "0.8.2"
+  },
+  {
+    "productTitle": "Portals React Native",
+    "pageUrl": "https://ionic.io/docs/portals/for-react-native/changelog",
+    "repo": "ionic-team/ionic-portals-react-native",
+    "mdBody": "### What's Changed\n* **fix(android)**: using correct topic name for storing subscriptions ([#62](https://github.com/ionic-team/ionic-portals-react-native/pull/62))\n\n",
+    "body": "<h3>What's Changed</h3>\n<ul>\n<li><strong>fix(android)</strong>: using correct topic name for storing subscriptions (<a href=\"https://github.com/ionic-team/ionic-portals-react-native/pull/62\">#62</a>)</li>\n</ul>\n",
+    "name": "0.8.1",
+    "raw_published_at": "2025-04-08T18:14:20Z",
+    "published_at": "April 8 2025",
+    "tag_name": "0.8.1",
+    "type": "patch",
+    "version": "0.8.1"
+  },
   {
     "productTitle": "Portals React Native",
     "pageUrl": "https://ionic.io/docs/portals/for-react-native/changelog",
diff --git a/website/docs/for-web/upgrade-guides.md b/website/docs/for-web/upgrade-guides.md
@@ -6,6 +6,18 @@ sidebar_label: Upgrade Guides
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
+## Portals Web Plugin 0.12.x → 0.13.0
+
+- Portals Web Plugin `0.13.0` is compatible with Portals for Android versions `0.13.x` and Portals for iOS versions `0.13.x`.
+
+:::caution
+Portals Web Plugin `0.13.0` is a notable update that requires Capacitor 8.
+Care should be taken to update dependencies across your web content and native apps to ensure compatibility.
+:::
+
+First review the [Capacitor 8 Update Guide](https://capacitorjs.com/docs/updating/8-0) for an overview of necessary changes.
+Some will not be relevant for Portals apps, but this will be a useful reference in case you encounter issues with your upgrade.
+
 ## Portals Web Plugin 0.10.x → 0.12.0
 
 - Portals Web Plugin `0.12.0` is compatible with Portals for Android versions `0.12.x` and Portals for iOS versions `0.12.x`.
