Skip to main content

Shiply 可以使用哪些发布条件？

一、平台默认支持的下发条件​

字段含义如下：

字段Android（RDeliverySetting）iOS（RDeliverySDKSettings）
机型devModeldeviceType
厂商devManufacturer默认 Apple
guidguidguid
系统版本androidSystemVersionsystemVersion
是否64位is64Bit无需关注，主要Android在用
用户百分比后台根据 guid字段计算后台根据 guid字段计算
应用平台的 appId平台的 appId
时间后台根据请求自动判断后台根据请求自动判断
地区后台根据请求自动判断后台根据请求自动判断
用户号码包后台根据 guid字段检查是否在特定号码包中后台根据 guid字段检查是否在特定号码包中
应用版本号hostAppVersionappVersion
平台默认Android默认iOS

支持的条件匹配方式如下，不同的字段支持的匹配方式有所不同。

  • 相等

  • 不相等

  • 包含

  • 不包含

  • 正则匹配

  • 正则不匹配

  • 在...中

  • 不在...中

  • >=、<=、>、<、=、!=

二、通过自定义属性扩展更多条件​

2.1 添加自定义属性​

Shiply 支持增加自定义属性，进而扩展支持无限多的条件类型。

开发者在「全局功能与设置-条件与号码包-新建自定义属性」，并选择自定义属性在哪些发布子系统生效

创建好的自定义属性如下

在创建任务页面，选择下发条件时，划到底部，可以看到我们新增的自定义属性：MyDeviceID，可将此作为下发条件

2.2 SDK 初始化时设置自定义属性​

iOS 配置与开关 SDK 设置​

RDeliverySDKSettings *setting = [RDeliverySDKSettings settingWithAppId:kRDeliveryDemoAppid      //在 RDelivery Web页面申请的项目的 appid
                                                                appKey:kRDeliveryDemoAppkey     //在 RDelivery Web页面申请的项目的 appkey
                                                                  guid:kRDeliveryDemoGuid1      //业务自己的user ID，用于配置按号码包规则的匹配
                                                               depends:depends];
// SDK 初始化时可在 RDeliverySDKSettings 中设置
setting.profiles = @{
  @"MyDeviceID": @"xxxx-xxxx-xxxx-xxxx",
};

// 初始化后，可在使用 setProfileValue:forKey 更新设置，并调用 updateConfigWithCompleteHandler:nil 重新拉取
[self.rdelivery setProfileValue:value forKey:key];
[self.rdelivery updateConfigWithCompleteHandler:nil];

iOS 资源与制品 SDK 设置​

ResHub *reshub = [[ResHubCenter sharedInstance] resHubWithAppId:[self appId] appKey:[self appKey] env:envId taget:ResHubTargetApp extraParam:extra];
// 设置后，需要调用拉取远程更新
[reshub setCustomPropertyValue:@"xxxx-xxxx-xxxx-xxxx" forKey:@"MyDeviceID"];
[reshub updateAllConfigsWithCompleted:nil];

Android 配置与开关 SDK 设置​

Map customParams = new HashMap<>();
customParams.put("testKey", "testValue");
RDeliverySetting setting = new RDeliverySetting.Builder()
        .setCustomProperties(customParams)
        .build();
//外部依赖
DependencyInjector injector = new DependencyInjector(
        new HttpsURLConnectionNetwork(this), // 网络接口的默认实现
        new MmkvStorageFactory(), // 存储接口的默认实现
        new HandlerTask(), // 任务调度接口的默认实现
        new SystemLog() // 日志接口的默认实现
);

RDelivery rDelivery = RDelivery.create(this, setting, injector, null);

// 更新自定义属性
rDelivery.setCustomParam("testKey", "testValue2");
// 更新自定义属性后，需要主动调用requestFullRemoteData，才会拉取到新的配置开关数据
rDelivery.requestFullRemoteData(null);

Android 资源与制品 SDK 设置​

Map<String, String> customParams = new HashMap<>();
customParams.put("testKey", "testValue");
ResHubParams params = new ResHubParams(
        "1.1.1",                     // appVersion
        "xxxx",                    // deviceId
        false,                       // isRdmTest
        ResHubCenter.LOCAL_PRESET_PATH_DEFAULT,
        true, false, ResHubCenter.CONFIG_STORE_SUFFIX_DEFAULT,
        customParams              // variantMap
);

ResHubCenter.INSTANCE.init(application,                // context
        params,                     // params
        new ResHubDefaultDownloadImpl(), // downloadDelegate
        new HttpsURLConnectionNetwork(context),  // networkDelegate
        new ResHubDefaultReportImpl()    // reportDelegate
);


IResHub reshub = ResHubCenter.INSTANCE.getResHub(appId, appKey,
        TargetType.AndroidApp,
        ResHubCenter.ENV_ONLINE,
        null, null, null
);
// 更新自定义属性
reshub.updateCustomProperties("testKey", "testValue2");
// 更新自定义属性后，需要主动调用requestFullRemoteData，才会拉取到新的资源任务
reshub.requestFullRemoteResConfig(null);

三、常见问题​

3.1 如何支持“或”条件？​

Shiply 同一个任务的多个条件之间是“且”的关系，多个条件需要同时满足。如果希望用到“或”条件，可以新建一个任务，两个任务之间是“或”的关系。