全部产品
Search
文档中心

SuperApp:小程序自定义UI基本配置

更新时间:Mar 31, 2026

本文描述了Android端自定义小程序UI配置的基本使用方法。

1. 自定义UI配置

a. 自定义主题色

public MiniAppUIConfig.Builder setThemeColor(int uiThemeColor)

b. 自定义字体

/**
* 字体资源以ID形式导入
*/
public MiniAppUIConfig.Builder setFontStyle(int fontStyleResourceId) 

/**
* 字体资源以String形式导入
*/
public MiniAppUIConfig.Builder setFontStyle(String fontStyle) 

c. 自定义小程序错误页图片

/**
* 自定义小程序无法打开时的提示图片
* 如图1
*/
public MiniAppUIConfig.Builder setPageNotOpenImage(Drawable pageNotOpenImage) 

/**
* 自定义网络错误时提示图片
* 如图2
*/
public MiniAppUIConfig.Builder setNetWorkErrorImage(Drawable netWorkErrorImage)

/**
* 自定义小程序加载失败时的提示图片
* 如图3
*/
public MiniAppUIConfig.Builder setAppLoadFailedImage(Drawable appLoadFailedImage)

/**
* 自定义小程序已下架/找不到时的提示图片
* 如图4
*/
public MiniAppUIConfig.Builder setAppNotFoundImage(Drawable appNotFoundImage)

/**
* 自定义小程序页面找不到时的提示图片
* 如图5
*/
public MiniAppUIConfig.Builder setPageNotFoundImage(Drawable pageNotFoundImage)

image.png

image.png

image.png

image.png

image.png

图1 小程序加载失败页

图2 网络错误页

图3 小程序打开失败页

图4 小程序未找到页

图5 页面未找到

2. 示例代码

MiniAppUIConfig miniAppUIConfig = new MiniAppUIConfig.Builder()
    .setThemeColor(Color.parseColor("#8B4513"))
    
    .setAppLoadFailedImage(application.getApplicationContext().getDrawable(R.drawable.mini_app_authorize_arrow))
    .setPageNotFoundImage(application.getApplicationContext().getDrawable(R.drawable.mini_app_authorize_arrow))
    .setPageNotOpenImage(application.getApplicationContext().getDrawable(R.drawable.mini_app_authorize_arrow))
    .setAppNotFoundImage(application.getApplicationContext().getDrawable(R.drawable.mini_app_authorize_arrow))
    .setNetWorkErrorImage(application.getApplicationContext().getDrawable(R.drawable.mini_app_authorize_arrow))
    .build();

MiniAppInitConfig config = new MiniAppInitConfig.Builder()
                .setUseWindVane(true)
                .setUseUniApp(false)
                .setHost("your Host")
                .setAppCode("your App Code")
                .setAccessKey("your access key")
                .setSecretKey("your secret key")
                .setNeedAuthFromApp(true)


                .setMiniAppUIConfig(miniAppUIConfig)

                .openLog(true)
                .build();