MeshtasticSchema.current to point to the new version.VersionedSchema. Migration history must be preserved or the migration plan will fail on devices that skipped intermediate versions.When a proto field is deprecated upstream and the app stops using it, do not remove the corresponding @Model property — deleting a stored property is a schema change that would require a migration, and while V1 is unreleased there is nowhere to migrate from. Instead, retain the property as-is so:
The field simply stops being surfaced in the UI, read, or actively written by app code. Mark it with a doc comment noting the deprecation and the tracking issue. Current examples:
+| Model | +Property | +Notes | +
|---|---|---|
CannedMessageConfigEntity |
+enabled |
+#2021 — no successor; retained for schema/value compatibility, no longer read or written | +
QuerySwiftData.swift contains helper functions for common fetches:
let node = getNodeInfo(id: nodeNum, context: context)
diff --git a/Meshtastic/Resources/docs/index.json b/Meshtastic/Resources/docs/index.json
index 0cd9d182d..46879116b 100644
--- a/Meshtastic/Resources/docs/index.json
+++ b/Meshtastic/Resources/docs/index.json
@@ -1025,20 +1025,20 @@
"node",
"stats",
"simctl",
+ "model",
"local",
"nodes",
+ "app",
"store",
- "model",
+ "schema",
"context",
"packet",
"history",
"data",
"child",
- "app",
"swift",
- "schema",
- "launch",
"device",
+ "launch",
"var",
"true",
"telemetry",
@@ -1050,7 +1050,7 @@
"type",
"set"
],
- "charCount": 11360
+ "charCount": 12115
},
{
"id": "tak-protocol",
diff --git a/Meshtastic/Resources/docs/markdown/developer/swiftdata.md b/Meshtastic/Resources/docs/markdown/developer/swiftdata.md
index 16bab1304..3e8fc27dc 100644
--- a/Meshtastic/Resources/docs/markdown/developer/swiftdata.md
+++ b/Meshtastic/Resources/docs/markdown/developer/swiftdata.md
@@ -157,6 +157,19 @@ static let migrateV1toV2 = MigrationStage.custom(
> **Warning — Never delete a `VersionedSchema`.** Migration history must be preserved or the migration plan will fail on devices that skipped intermediate versions.
+### Deprecated Properties
+
+When a proto field is deprecated upstream and the app stops using it, **do not remove the corresponding `@Model` property** — deleting a stored property is a schema change that would require a migration, and while V1 is unreleased there is nowhere to migrate from. Instead, retain the property as-is so:
+
+- the SwiftData schema is unchanged, and
+- any values already persisted on-device remain readable.
+
+The field simply stops being surfaced in the UI, read, or actively written by app code. Mark it with a doc comment noting the deprecation and the tracking issue. Current examples:
+
+| Model | Property | Notes |
+|-------|----------|-------|
+| `CannedMessageConfigEntity` | `enabled` | #2021 — no successor; retained for schema/value compatibility, no longer read or written |
+
## Query Helpers
`QuerySwiftData.swift` contains helper functions for common fetches:
diff --git a/Meshtastic/Views/Settings/Config/Module/CannedMessagesConfig.swift b/Meshtastic/Views/Settings/Config/Module/CannedMessagesConfig.swift
index 9e96a54bb..02d3a514c 100644
--- a/Meshtastic/Views/Settings/Config/Module/CannedMessagesConfig.swift
+++ b/Meshtastic/Views/Settings/Config/Module/CannedMessagesConfig.swift
@@ -17,7 +17,6 @@ struct CannedMessagesConfig: View {
@State var hasChanges = false
@State var hasMessagesChanges = false
@State var configPreset = 0
- @State var enabled = false
/// CannedMessageModule will sends a bell character with the messages.
@State var sendBell: Bool = false
/// Enable the rotary encoder #1. This is a 'dumb' encoder sending pulses on both A and B pins while rotating.
@@ -43,12 +42,6 @@ struct CannedMessagesConfig: View {
Section(header: Text("Options")) {
- Toggle(isOn: $enabled) {
-
- Label("Enabled", systemImage: "list.bullet.rectangle.fill")
- }
- .tint(.accentColor)
-
Toggle(isOn: $sendBell) {
Label("Send Bell", systemImage: "bell")
@@ -184,7 +177,8 @@ struct CannedMessagesConfig: View {
dismiss: goBack
) { fromUser, toUser in
var cmc = ModuleConfig.CannedMessageConfig()
- cmc.enabled = enabled
+ // enabled is deprecated with no successor and removed from active
+ // use — intentionally not written. (#2021)
cmc.sendBell = sendBell
cmc.rotary1Enabled = rotary1Enabled
cmc.updown1Enabled = updown1Enabled
@@ -265,9 +259,6 @@ struct CannedMessagesConfig: View {
hasChanges = true
}
- .onChange(of: enabled) { _, newEnabled in
- if newEnabled != node?.cannedMessageConfig?.enabled { hasChanges = true }
- }
.onChange(of: sendBell) { _, newSendBell in
if newSendBell != node?.cannedMessageConfig?.sendBell { hasChanges = true }
}
@@ -297,7 +288,6 @@ struct CannedMessagesConfig: View {
}
}
func setCannedMessagesValues() {
- self.enabled = node?.cannedMessageConfig?.enabled ?? false
self.sendBell = node?.cannedMessageConfig?.sendBell ?? false
self.rotary1Enabled = node?.cannedMessageConfig?.rotary1Enabled ?? false
self.updown1Enabled = node?.cannedMessageConfig?.updown1Enabled ?? false
diff --git a/docs/developer/swiftdata.md b/docs/developer/swiftdata.md
index 16bab1304..3e8fc27dc 100644
--- a/docs/developer/swiftdata.md
+++ b/docs/developer/swiftdata.md
@@ -157,6 +157,19 @@ static let migrateV1toV2 = MigrationStage.custom(
> **Warning — Never delete a `VersionedSchema`.** Migration history must be preserved or the migration plan will fail on devices that skipped intermediate versions.
+### Deprecated Properties
+
+When a proto field is deprecated upstream and the app stops using it, **do not remove the corresponding `@Model` property** — deleting a stored property is a schema change that would require a migration, and while V1 is unreleased there is nowhere to migrate from. Instead, retain the property as-is so:
+
+- the SwiftData schema is unchanged, and
+- any values already persisted on-device remain readable.
+
+The field simply stops being surfaced in the UI, read, or actively written by app code. Mark it with a doc comment noting the deprecation and the tracking issue. Current examples:
+
+| Model | Property | Notes |
+|-------|----------|-------|
+| `CannedMessageConfigEntity` | `enabled` | #2021 — no successor; retained for schema/value compatibility, no longer read or written |
+
## Query Helpers
`QuerySwiftData.swift` contains helper functions for common fetches: