增加注释

Author: hupei

acp/src/main/java/com/mylhyl/acp/Acp.java

@@ -23,9 +23,15 @@ private Acp(Context context) {
         mAcpManager = new AcpManager(context.getApplicationContext());
     }
 
+    /**
+     * 开始请求权限
+     *
+     * @param options
+     * @param acpListener
+     */
     public void request(AcpOptions options, AcpListener acpListener) {
-        if (options == null) new RuntimeException("AcpOptions is null...");
-        if (acpListener == null) new RuntimeException("AcpListener is null...");
+        if (options == null) new NullPointerException("AcpOptions is null...");
+        if (acpListener == null) new NullPointerException("AcpListener is null...");
         mAcpManager.request(options, acpListener);
     }
 

acp/src/main/java/com/mylhyl/acp/AcpListener.java

@@ -6,7 +6,13 @@
  * Created by hupei on 2016/4/26.
  */
 public interface AcpListener {
+    /**
+     *同意
+     */
     void onGranted();
 
+    /**
+     * 拒绝
+     */
     void onDenied(List<String> permissions);
 }

acp/src/main/java/com/mylhyl/acp/AcpOptions.java

@@ -57,31 +57,67 @@ public static class Builder {
         private String mRationalBtn = DEF_RATIONAL_BTN_TEXT;
         private String[] mPermissions;
 
+        /**
+         * 申请权限框提示语
+         *
+         * @param rationalMessage
+         * @return
+         */
         public Builder setRationalMessage(String rationalMessage) {
             mRationalMessage = rationalMessage;
             return this;
         }
 
+        /**
+         * 申请权限框按钮
+         *
+         * @param rationalBtnText
+         * @return
+         */
+        public Builder setRationalBtn(String rationalBtnText) {
+            this.mRationalBtn = rationalBtnText;
+            return this;
+        }
+
+        /**
+         * 拒绝框提示语
+         *
+         * @param deniedMessage
+         * @return
+         */
         public Builder setDeniedMessage(String deniedMessage) {
             mDeniedMessage = deniedMessage;
             return this;
         }
 
+        /**
+         * 拒绝框关闭按钮
+         *
+         * @param deniedCloseBtnText
+         * @return
+         */
         public Builder setDeniedCloseBtn(String deniedCloseBtnText) {
             this.mDeniedCloseBtn = deniedCloseBtnText;
             return this;
         }
 
+        /**
+         * 拒绝框跳转设置权限按钮
+         *
+         * @param deniedSettingText
+         * @return
+         */
         public Builder setDeniedSettingBtn(String deniedSettingText) {
             this.mDeniedSettingBtn = deniedSettingText;
             return this;
         }
 
-        public Builder setRationalBtn(String rationalBtnText) {
-            this.mRationalBtn = rationalBtnText;
-            return this;
-        }
-
+        /**
+         * 需要申请的权限
+         *
+         * @param mPermissions {@linkplain android.Manifest.permission android.Manifest.permission}
+         * @return
+         */
         public Builder setPermissions(String... mPermissions) {
             this.mPermissions = mPermissions;
             return this;

acp/src/main/java/com/mylhyl/acp/AcpService.java

@@ -9,6 +9,13 @@
  * Created by hupei on 2016/4/26.
  */
 class AcpService {
+    /**
+     * 检查权限授权状态
+     *
+     * @param context
+     * @param permission
+     * @return
+     */
     int checkSelfPermission(Context context, String permission) {
         return ContextCompat.checkSelfPermission(context, permission);
     }