NativeScript / NativeScript/nx
Outdated CLI Flags in Documentation for @nativescript/nx Version 20
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- TypeScript
- Sterne
- 68
- Forks
- 15
- PR-Merge-Kennzahlen
- Keine gemergten PRs in 30 T.
Beschreibung
After updating @nativescript/nx from version 18 to version 20, I noticed that the executor interface has changed, and some command-line flags are no longer recognized as before. Specifically, options like --aab, --key-store-path, and --provision are now nested under platform-specific objects (android, ios, etc.) and require a different syntax when used in build commands.
However, the current documentation still reflects the old interface, which can lead to confusion and build failures for developers upgrading to version 20.
Current Documentation Examples (Outdated):
For Android:
npx nx build <app-name> android --c=prod \
--aab \
--key-store-path=<path-to-your-keystore> \
--key-store-password=<your-key-store-password> \
--key-store-alias=<your-alias-name> \
--key-store-alias-password=<your-alias-password> \
--copyTo=./dist/build.aab
For IOS:
npx nx build <app-name> ios --c=prod \
--provision <provisioning-profile-name> \
--copy-to ./dist/build.ipa
Issue:
With the updated executor schema in version 20, these flags are nested inside of android and IOS object:
export interface ExecutorSchema extends BaseSchema, BuildSchema, DebugSchema, PrepareSchema, RunSchema, TestSchema {
android: AndroidSchema;
ios: IosSchema;
visionos: visionOSSchema;
}
export interface AndroidSchema {
aab: boolean;
keyStoreAlias: string;
keyStoreAliasPassword: string;
keyStorePassword: string;
keyStorePath: string;
xmlUpdates: Record<string, any>;
}
export interface IosSchema {
plistUpdates: Record<string, any>;
provision: string;
}
Proposed Documentation Update:
For Android:
npx nx build <app-name> android --c=prod \
--android.aab=true \
--android.keyStorePath=<path-to-your-keystore> \
--android.keyStorePassword=<your-key-store-password> \
--android.keyStoreAlias=<your-alias-name> \
--android.keyStoreAliasPassword=<your-alias-password> \
--copyTo=./dist/build.aab
For iOS:
npx nx build <app-name> ios --c=prod \
--ios.provision=<provisioning-profile-name> \
--copyTo=./dist/build.ipa
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Suchen Sie die Dokumentationsseite mit den Android- und iOS-Build-Beispielen und vergleichen Sie sie mit den im Issue gezeigten ExecutorSchema, AndroidSchema und IosSchema der Version 20. Aktualisieren Sie die Beispiele so, dass sie die verschachtelte Optionssyntax verwenden, und überprüfen Sie anschließend, dass beide Befehle dem dokumentierten Schema entsprechen und eine einheitliche Schreibweise von copyTo verwenden.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- typescript
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 2/5
- Geschätzter Aufwand
- 1-3 Stunden
- Aktivitätsstatus
- Veraltet
- Klarheit
- Klar beschrieben
- Anfängerfreundlichkeit
- 45/100