Android Management API Deprecations
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Idoneità per principianti
- 35/100
Direzione di ricerca
Iniziare confrontando Android Management API Client con la documentazione di riferimento di Android Management API, utilizzando Policies e il campo statusBarDisabled come esempio. Identificare i campi e i metodi obsoleti e le relative alternative documentate, quindi verificare che ogni membro client corrispondente abbia un'annotazione @Deprecated e JavaDoc che descriva la sostituzione.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
While having a look at the Android Management API Client in comparison with the reference documentation, I noticed that there are some fields and methods marked as deprecated within the reference but not within the Java client library.
E.g.: "statusBarDisabled" of Policies.
As developer I'd love to notice deprecated API fields inside the related client code, so I can handle them directly when using them.
My suggestion would be to include a proper @Deprecated annotation in combination with a good JavaDoc which leads me to the correct place. This would increase the visibility of deprecation within the regular development process.
E.g:
/**
* Password requirements. The field password_requirements.require_password_unlock must not be set.
*
* @deprecated Use passwordPolicies instead.
*
* Note: Complexity-based values of PasswordQuality, that is,
* COMPLEXITY_LOW, COMPLEXITY_MEDIUM, and COMPLEXITY_HIGH, cannot be used here.
* unified_lock_settings cannot be used here.
* @param passwordRequirements passwordRequirements or {@code null} for none
*/
@Deprecated
public Policy setPasswordRequirements(PasswordRequirements passwordRequirements) {
this.passwordRequirements = passwordRequirements;
return this;
}
I'm willing to contribute with a PR containing the annotations of deprecations of the Android Management API together with proper documentation about alternatives as described within the API reference documentation. Just add the "Accepting Contributions" label and I'll set up a PR for it.
- Lingua principale
- Java
- Stelle
- 725
- Fork
- 394
- Merge medio
- 45m
- PR unite (30g)
- 240
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di googleapis/google-api-java-client-services
-
priority: p3 type: docs
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 88/100
-
Difficoltà 3/5 1-2 giorni Idoneità per principianti 65/100
-
priority: p3 type: bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 50/100
googleapis/google-api-java-client-services#29581 · 2 commenti ·
-
priority: p3 type: feature request
Difficoltà 4/5 3-5 giorni Idoneità per principianti 38/100
googleapis/google-api-java-client-services#29317 · 1 commento ·
-
priority: p3 type: bug
Difficoltà 5/5 Più di una settimana Idoneità per principianti 35/100
googleapis/google-api-java-client-services#26505 · 7 commenti · 1 reazione ·
Tutte le issue di googleapis/google-api-java-client-services
Issue simili
-
documentation
Difficoltà 2/5 1-3 ore Idoneità per principianti 65/100
inu-appcenter/memorIN-backend#288 ·
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 65/100
-
frontend maui-pilot pilot-ask question
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
-
executions.Query — startDate and timeRange filters are sent with inverted comparison operators Apertaarea/plugin
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
kestra-io/plugin-kestra#190 ·