Skip to content

Commit b8019b5

Browse files
jaredlockhartclaude
andcommitted
docs: iOS parity, fetch control, and deprecation notice updates
Because * iOS integration guide was missing recordMalformedConfiguration() that was added to the Android guide * setFetchEnabled/isFetchEnabled QA methods were undocumented * Deprecated custom-targeting docs didn't link to the new recordedContext builder option in the integration guides This commit * Adds recordMalformedConfiguration() section to iOS integration guide * Adds setFetchEnabled/isFetchEnabled section to mobile-ui.md * Updates deprecated custom-targeting notices on both Android and iOS to link to the integration guide's recordedContext section Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 93fdf4c commit b8019b5

4 files changed

Lines changed: 21 additions & 2 deletions

File tree

docs/platform-guides/android/custom-targeting.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ slug: /platform-guides/android/custom-targeting
55
---
66

77
:::warning DEPRECATED
8-
**This method of adding new targeting attributes is deprecated. Please use the method described in the [Recorded Targeting Context doc](/advanced/recording-targeting-context#adding-new-fields).**
8+
**This method of adding new targeting attributes is deprecated.** Use the `recordedContext` NimbusBuilder option instead — see the [integration guide](/platform-guides/android/integration#connecting-to-the-recorded-targeting-context) and the [Recorded Targeting Context doc](/advanced/recording-targeting-context#adding-new-fields) for details.
99
:::
1010

1111
## Adding New Targeting Attributes to Android

docs/platform-guides/android/mobile-ui.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,15 @@ This disqualifies existing enrollments. and breaks any connection with experimen
4040
4141
[nimbus-cli]: https://github.com/mozilla/application-services/tree/main/components/support/nimbus-cli
4242

43+
### Disabling Experiment Fetch
44+
45+
For QA testing, you can disable fetching of experiments from Remote Settings. This is used by the `nimbus-cli` tooling and is not intended for end users.
46+
47+
```kotlin
48+
nimbus.setFetchEnabled(false) // disable fetching
49+
nimbus.isFetchEnabled() // check current state
50+
```
51+
4352
### Preview Collection
4453

4554
To allow testing of experiments before they are published, the client should allow configuring the Nimbus startup to use the `preview-collection`.

docs/platform-guides/ios/custom-targeting.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ slug: /platform-guides/ios/custom-targeting
66
## Adding New Targeting Attributes to iOS
77

88
:::warning DEPRECATED
9-
**This method of adding new targeting attributes is deprecated. Please use the method described in the [Recorded Targeting Context doc](/advanced/recording-targeting-context#adding-new-fields).**
9+
**This method of adding new targeting attributes is deprecated.** Use the `recordedContext` NimbusBuilder option instead — see the [integration guide](/platform-guides/ios/integration#connecting-to-the-recorded-targeting-context) and the [Recorded Targeting Context doc](/advanced/recording-targeting-context#adding-new-fields) for details.
1010
:::
1111

1212
This page demonstrates how to add new targeting attributes to iOS, enabling experiment creators more specific targeting.

docs/platform-guides/ios/integration.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -184,6 +184,16 @@ To connect the `NimbusInterface` object to the command line, we need to feed the
184184
.build(appInfo: appInfo)
185185
```
186186

187+
### Reporting malformed feature configuration
188+
189+
If your app detects that a feature configuration from an experiment is invalid or malformed, you can report it as telemetry using `recordMalformedConfiguration`:
190+
191+
```swift
192+
AppConfig.shared.features.newtab.recordMalformedConfiguration(partId: "invalid-card")
193+
```
194+
195+
This sends a `malformedConfiguration` Glean event identifying the feature and the specific part that was invalid.
196+
187197
## A complete `NimbusBuilder` example
188198

189199
```swift

0 commit comments

Comments
 (0)