1. 框架接入

业务包通用配置说明

【注意事项】

我们目前已经废弃 classpath 'com.tuya.android.module:tymodule-config:latestVersion' 请移除

1.1. 版本说明

业务包支持 minSdkVersion 为 19，targetSdkVersion 为 29，仅支持 Anroidx 构建。

1.2. 业务包配置文件

业务包更新时必须重新下载配置文件

1.2.1. assets 配置

module_app.json 和 x_platform_config.json 为服务化配置文件，请拷贝至 app 目录下的 assets 文件夹下即可生效。[必选]

1.2.2. res 配置

res/values/ty_config.xml业务包配置文件及默认颜色[[必选]

res/values配置文件[必选]

res多语言文件可根据情况选择配置 [可选]

主题色配置

res/values/ty_theme_config.xml主题资源配置[必选]

res/values/ty_theme_main_colors.xml主题色res资源配置[必选]

assets/tyTheme/ui_theme_config.json主题色assets资源配置[必选]

说明: 需要同时修改ty_theme_main_colors.xml和ui_theme_config.json两个文件的内容来实现主题色配置。ty_theme_config.xml不允许更改，直接放入工程即可。

'ty_theme_main_colors.xml'说明：

'ui_theme_config.json'说明:

{
    "color_alpha":{
        "N1":0.9,
        "N2":0.7,
        "N3":0.5,
        "N4":0.3,
        "N5":0.7,
        "N6":0.2,
        "N7":0.1,
        "N8":0.4
    },
    "colors":{
        "B1":"#F8F8F8",
        "B2":"#FFFFFF",
        "B3":"#FFFFFF",
        "B4":"#FFFFFF",
        "B5":"#FFFFFF",
        "M1":"#FF5A28", // 可以修改M1字段的值来配置主题色
        "M2":"#FF4444",
        "M3":"#00CC99",
        "M4":"#1989FA",
        "M5":"#FF5A28"
    },
    "corner":{
        "alert_corner_type":"angle",
        "button_corner_type":"angle",
        "card_corner_type":"angle"
    },
    "font":{
        "app_bold_font":"",
        "app_font":""
    }
}

• 通过修改colors下M1字段的值来实现主题色配置。其他属性字段不要进行修改。

drawable 配置

bg_text_bts.xml

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">

    <item android:state_focused="true">
        <shape android:shape="rectangle">
            <corners android:radius="@dimen/mg_2" />

            <solid android:color="@color/primary_button_select_color" />
        </shape>
    </item>
    <item android:state_selected="true">
        <shape android:shape="rectangle">
            <corners android:radius="@dimen/mg_2" />

            <solid android:color="@color/primary_button_select_color" />
        </shape>
    </item>
    <item android:state_pressed="true">
        <shape android:shape="rectangle">
            <corners android:radius="@dimen/mg_2" />

            <solid android:color="@color/primary_button_select_color" />
        </shape>
    </item>
    <item android:state_enabled="true">
        <shape android:shape="rectangle">
            <corners android:radius="@dimen/mg_2" />

            <solid android:color="@color/primary_button_bg_color" />
        </shape>
    </item>
    <item android:state_enabled="false">
        <shape>
            <corners android:radius="@dimen/mg_2" />

            <solid android:color="@color/gray_99" />
        </shape>
    </item>

</selector>

1.2.3. style 配置

res/values/styles.xml业务包主题文件[必选]

    <!-- Base application theme. -->
    <style name="Base_BizBundle_Theme" parent="AppTheme">
        <item name="status_font_color">@color/status_font_color</item>
        <item name="status_bg_color">@color/status_bg_color</item>
        <item name="navbar_font_color">@color/navbar_font_color</item>
        <item name="navbar_bg_color">@color/navbar_bg_color</item>
        <item name="app_bg_color">@color/app_bg_color</item>
        <item name="fragment_bg_color">@color/app_bg_color</item>
        <item name="list_primary_color">@color/list_primary_color</item>
        <item name="list_sub_color">@color/list_sub_color</item>
        <item name="list_secondary_color">@color/list_secondary_color</item>
        <item name="list_line_color">@color/list_line_color</item>
        <item name="list_bg_color">@color/list_bg_color</item>
        <item name="primary_button_font_color">@color/primary_button_font_color</item>
        <item name="primary_button_bg_color">@color/primary_button_bg_color</item>
        <item name="secondary_button_font_color">@color/secondary_button_font_color</item>
        <item name="secondary_button_bg_color">@color/secondary_button_bg_color</item>
        <item name="notice_font_color">@color/notice_font_color</item>
        <item name="notice_bg_color">@color/notice_bg_color</item>
        <item name="bg_normal_text_bt">@drawable/bg_text_bts</item>
        <item name="app_name">@string/app_name</item>
        <item name="is_splash_used">false</item>
        <item name="ap_default_ssid">@string/ap_mode_ssid</item>
        <item name="ap_connect_description">@string/ty_ap_connect_description</item>
        <item name="is_scan_support">@bool/is_scan_support</item>
        <item name="is_need_blemesh_support">@bool/is_need_blemesh_support</item>
        <item name="status_bg_color_75">@color/status_bg_color_75</item>
        <item name="status_bg_color_90">@color/status_bg_color_90</item>
    </style>

1.2.4. AndroidManifest.xml 配置

    <!-- 必选配置 -->
    <application
        android:supportsRtl="false"
        android:theme="@style/Base_BizBundle_Theme"
        tools:replace="android:theme"/>

1.2.5. 依赖源配置

根目录的 build.gradle 文件

allprojects {
    repositories {
        jcenter()
        maven { url 'https://jitpack.io' }
    }
}

app 的 build.gradle 文件 只支持 arm 架构的 cpu 版本

android {
    packagingOptions {
        pickFirst 'lib/*/libc++_shared.so'
        pickFirst 'lib/*/libgnustl_shared.so'
    }

    lintOptions {
        abortOnError false
    }

    defaultConfig {
        ndk { abiFilters "armeabi-v7a", "arm64-v8a" }
    }

    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

1.2.6. Application 初始化

业务包初始化通用部分

    // 请不要修改初始化顺序
    Fresco.initialize(this);
    // SDK 初始化
    TuyaHomeSdk.init(this);

    // 业务包初始化
    TuyaWrapper.init(this, new RouteEventListener() {
        @Override
        public void onFaild(int errorCode, UrlBuilder urlBuilder) {
                // 路由未实现回调
                // urlBuilder.target is a router address, urlBuilder.params is a router params
                // urlBuilder.target 目标路由， urlBuilder.params 路由参数
                Log.e("router not implement", urlBuilder.target + urlBuilder.params.toString());
        }
    }, new ServiceEventListener() {
        @Override
        public void onFaild(String serviceName) {
                // 服务未实现回调
                Log.e("service not implement", serviceName);
        }
    });
    TuyaOptimusSdk.init(this);

    // 注册家庭服务，商城业务包可以不注册此服务
    TuyaWrapper.registerService(AbsBizBundleFamilyService.class, new BizBundleFamilyServiceImpl());

1.2.7. 登录和退出

业务包接入后，应在账号登录和退出时分别调用如下方法

    //登录
    TuyaWrapper.onLogin();
    //退出
    TuyaWrapper.onLogout(Context context);

1.2.8. 实现家庭服务

通过继承 AbsBizBundleFamilyService 抽象类，实现设置当前家庭 homeId

示例代码

public class BizBundleFamilyServiceImpl extends AbsBizBundleFamilyService {

    private long mHomeId;

    @Override
    public long getCurrentHomeId() {
        return mHomeId;
    }

    @Override
    public void setCurrentHomeId(long homeId) {
        mHomeId = homeId;
    }
}

1.2.9. 设置家庭 HomeId

当获取家庭列表后，通过服务化调用设置家庭 homeId

示例代码

    AbsBizBundleFamilyService service = MicroServiceManager.getInstance().findServiceByInterface(AbsBizBundleFamilyService.class.getName());
    //设置为当前家庭的homeId
    service.setCurrentHomeId(homeBean.getHomeId());