Skip to content

BREAKING.md

Latest commit

 

History

History
128 lines (92 loc) · 4.34 KB

BREAKING.md

File metadata and controls

128 lines (92 loc) · 4.34 KB
Raw

Breaking Changes

This is a comprehensive list of the breaking changes introduced in the major version releases of the Ionic CLI.

Versions

Older majors are archived under BREAKING_ARCHIVE/ (e.g. BREAKING_ARCHIVE/v7.md). When the next major begins, move the section below into BREAKING_ARCHIVE/v8.md and start a fresh Version 9.x section here.

Version 8.x

In version 8, the Ionic CLI is focused on the Framework and Capacitor workflows. The Appflow, Enterprise, and Cordova commands have been removed.

Removed Commands

The following commands have been removed. Each entry records what was removed, why, and the migration path / alternative.

Note: The removal PRs are authored and coordinated separately. The entries below are seeded placeholders — each removal PR should fill in the specifics (the exact diff, the reason, and the migration link) for the command it removes.

config

  • What: The config command (and its config get / config set / config unset subcommands) has been removed. <TODO: confirm exact surface removed in the removal PR.>
  • Why: <TODO: rationale — CLI configuration scope reduced for the Framework/Capacitor-focused CLI.>
  • Migration: <TODO: alternative / link.>

cordova

  • What: The cordova command group has been removed. <TODO: confirm exact surface removed.>
  • Why: <TODO: Cordova retirement in favor of Capacitor.>
  • Migration: Migrate to Capacitor. <TODO: link to the Capacitor migration guide.>

enterprise

  • What: The enterprise command group has been removed. <TODO: confirm exact surface removed.>
  • Why: <TODO: Ionic Enterprise tooling retirement.>
  • Migration: <TODO: point Enterprise users to current Appflow / Enterprise tooling.>

git

  • What: The git command group has been removed. <TODO: confirm exact surface removed.>
  • Why: <TODO: tied to Appflow remote workflows being retired from the CLI.>
  • Migration: <TODO: alternative / link.>

init

  • What: The init command has been removed. <TODO: confirm exact surface removed.>
  • Why: <TODO: rationale.>
  • Migration: <TODO: alternative — e.g. ionic start / Capacitor init.>

integrations (Enterprise portion only)

  • What: The Enterprise portion of the integrations command has been removed. The Capacitor integration is kept. <TODO: confirm exact subcommands/flags removed vs. retained.>
  • Why: <TODO: Enterprise integration retirement; Capacitor remains a first-class workflow.>
  • Migration: Continue using ionic integrations enable capacitor. <TODO: link.>

link

  • What: The link command has been removed. <TODO: confirm exact surface removed.>
  • Why: <TODO: Appflow app-linking retirement.>
  • Migration: <TODO: point Appflow users to current Appflow tooling.>

live-update

  • What: The live-update command group has been removed. <TODO: confirm exact surface removed.>
  • Why: <TODO: Appflow Live Updates retirement from the CLI.>
  • Migration: <TODO: point users to current Appflow Live Updates tooling.>

login

  • What: The login command has been removed. <TODO: confirm exact surface removed.>
  • Why: <TODO: Ionic account auth no longer needed by the CLI.>
  • Migration: <TODO: alternative / link.>

logout

  • What: The logout command has been removed. <TODO: confirm exact surface removed.>
  • Why: <TODO: counterpart to login removal.>
  • Migration: <TODO: alternative / link.>

repair

  • What: The repair command has been removed. <TODO: confirm exact surface removed.>
  • Why: <TODO: rationale.>
  • Migration: <TODO: alternative / link.>

signup

  • What: The signup command has been removed. <TODO: confirm exact surface removed.>
  • Why: <TODO: Ionic account flows removed from the CLI.>
  • Migration: <TODO: alternative / link.>

ssh

  • What: The ssh command group (and its subcommands) has been removed. <TODO: confirm exact surface removed.>
  • Why: <TODO: Appflow SSH key management retirement from the CLI.>
  • Migration: <TODO: point Appflow users to current Appflow tooling.>