Android Management API Deprecations
还没有人认领这个 Issue。
评估
调研方向
首先将 Android Management API Client 与 Android Management API 参考文档进行比较,以 Policies 和 statusBarDisabled 字段为例。识别已弃用的字段和方法及其文档中说明的替代项,然后验证每个对应的客户端成员都具有 @Deprecated 注解,并且 JavaDoc 描述了替代项。
由索引模型根据 Issue 内容生成。
描述
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.
- 主要语言
- Java
- 星标
- 725
- 派生
- 394
- 平均合并
- 45 分钟
- 30 天内合并 PR
- 240
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
googleapis/google-api-java-client-services 的其他 Issue
-
priority: p3 type: docs
难度 1/5 1 小时以内 新手友好度 88/100
-
难度 3/5 1-2 天 新手友好度 65/100
-
priority: p3 type: bug
难度 2/5 1-3 小时 新手友好度 50/100
googleapis/google-api-java-client-services#29581 · 2 条评论 ·
-
priority: p3 type: feature request
难度 4/5 3-5 天 新手友好度 38/100
googleapis/google-api-java-client-services#29317 · 1 条评论 ·
-
priority: p3 type: bug
难度 5/5 一周以上 新手友好度 35/100
googleapis/google-api-java-client-services#26505 · 7 条评论 · 1 个 reaction ·
查看 googleapis/google-api-java-client-services 的全部 Issue
相似的 Issue
-
documentation
难度 2/5 1-3 小时 新手友好度 65/100
inu-appcenter/memorIN-backend#288 ·
-
难度 2/5 1-3 小时 新手友好度 65/100
-
frontend maui-pilot pilot-ask question
难度 2/5 1-3 小时 新手友好度 75/100
-
难度 2/5 1-3 小时 新手友好度 75/100
-
area/plugin
难度 2/5 1-3 小时 新手友好度 75/100
kestra-io/plugin-kestra#190 ·