Android Management API Deprecations
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 35/100
Hướng nghiên cứu
Bắt đầu bằng cách so sánh Android Management API Client với tài liệu tham chiếu Android Management API, sử dụng Policies và trường statusBarDisabled làm ví dụ. Xác định các trường và phương thức đã lỗi thời cùng với các phương án thay thế được ghi trong tài liệu, sau đó kiểm tra rằng mỗi thành viên tương ứng của client đều có chú thích @Deprecated và JavaDoc mô tả phương án thay thế.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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.
- Ngôn ngữ chính
- Java
- Star
- 725
- Fork
- 394
- Merge trung bình
- 45 phút
- Pull request đã merge (30 ngày)
- 240
Hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của googleapis/google-api-java-client-services
-
priority: p3 type: docs
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 65/100
-
priority: p3 type: bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 50/100
googleapis/google-api-java-client-services#29581 · 2 bình luận ·
-
priority: p3 type: feature request
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 38/100
googleapis/google-api-java-client-services#29317 · 1 bình luận ·
-
priority: p3 type: bug
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 35/100
googleapis/google-api-java-client-services#26505 · 7 bình luận · 1 reaction ·
Tất cả issue của googleapis/google-api-java-client-services
Issue tương tự
-
area-deployment area-integrations triage:bot-seen
Độ khó 2/5 Nửa ngày Mức phù hợp với người mới 86/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
apache/flink-agents#1156 ·
-
[source-shopify] FAILED bulk operation without partialDataUrl is silently treated as successful Đang mởarea/connectors autoteam community connectors/source/shopify needs-triage team/use type/bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 84/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 85/100