使用SDK接入

将应用接入功能开关后,即可使用功能开关的全部功能。本文将帮助您了解如何使用SDK方式接入应用。

操作步骤

  1. 登录 AHAS控制台,然后在页面左上角选择地域
  2. 在左侧导航栏选择功能开关,然后在页面右上角单击新应用接入
  3. 可选:新应用接入页面中查看并保存 License。
    说明 License在页面的第三步描述中有显示,仅公网环境接入需要License。
    查看license
  4. 在Pom文件中加入以下依赖。
    <dependency>
        <groupId>com.alibaba.csp</groupId>
        <artifactId>ahas-switch-client</artifactId>
        <version>x.y.z</version>
    </dependency>
    说明 新应用接入页面查看Pom依赖最新版本,将 x.y.z 替换为新版本的版本号。
  5. 定义功能开关。
    1. 在字段上加上com.taobao.csp.switchcenter.annotation.AppSwitch 注解,字段修饰符必须为 public static。例如以下代码:
      public class CommonTypeSwitch {
      
          @AppSwitch(des = "String 类型开关", level = Level.p2)
          public static String stringSwitch = "string";
      
          @AppSwitch(des = "Integer 类型开关", level = Level.p1)
          public static Integer integerSwitch = 2;
      }
    2. 初始化。
      /* 
          调用此方法完成初始化,请尽量确保在应用启动时调用。应用名参数可不填,默认取 project.name 启动参数作为appName参数。
          常量类参数是可变参数,支持同时注册多个常量类。如有需要,可按把不同功能模块的开关定义到不同常量类来做管控。
       */
      SwitchManager.init("appName", CommonTypeSwitch.class);
                                  
  6. 配置启动参数。
    • 非公网:
      //将 AppName 替换为自定义的应用名称。
      ahas.namespace=default
      project.name=AppName
    • 公网:
      //将 AppName 替换为自定义的应用名称,将 <license> 替换为真实值。
      ahas.namespace=default
      project.name=AppName
      ahas.license=<license>
  7. 重新部署您的应用。

执行结果

启动应用并调用配置埋点的方法。若该应用出现在AHAS控制台功能开关页面,则说明接入成功。