Todos os produtos
Search
Central de documentação

SuperApp:MiniAppInitConfig.Builder

Última atualização: Jun 29, 2026

Classe Builder para construção de objetos MiniAppInitConfig.

Classe Builder para MiniAppInitConfig. Constrói objetos de configuração de inicialização de miniapp.

public static class Builder

setAccessKey

public MiniAppInitConfig.Builder setAccessKey(String accessKey)

Defina um AccessKey.

Parameters

accessKey

String: o AccessKey, que pode ser obtido na Application Open Platform.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setSecretKey

public MiniAppInitConfig.Builder setSecretKey(String secret)

Defina uma SecretKey.

Parameters

secretKey

String: a SecretKey, que pode ser obtida na Application Open Platform.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setUseUniApp

public MiniAppInitConfig.Builder setUseUniApp(boolean use)

Ative o contêiner de miniapp uni-app. Desativado por padrão.

Parameters

use

Boolean: true para ativar, false para desativar. Padrão: false.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setUseWindVane

public MiniAppInitConfig.Builder setUseWindVane(boolean use)

Ative o contêiner de miniapp WindVane. Desativado por padrão.

Parameters

use

Boolean: true para ativar, false para desativar. Padrão: false.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setAppCode

public MiniAppInitConfig.Builder setChannel(String appCode)

Defina um App Code.

Parameters

appCode

String: o ID do aplicativo, que pode ser obtido na Application Open Platform.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setHost

public MiniAppInitConfig.Builder setHost(String host)

Defina o host do serviço de backend para um miniapp.

Parameters

host

String: o host do serviço de backend.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setUseHttp

public MiniAppInitConfig.Builder setUseHttp(boolean http)

Altera o protocolo para HTTP. HTTPS é usado por padrão.

Parameters

http

Boolean: true para HTTP, false para HTTPS. Padrão: false.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

openLog

public MiniAppInitConfig.Builder openLog(boolean open)

Ative o registro de log. Desativado por padrão.

Parameters

open

Boolean: true para ativar, false para desativar. Padrão: false.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setCustomOAID

public MiniAppInitConfig.Builder setCustomOAID(String oaid)

Defina o OAID para conectar o sistema de contas da Alibaba Cloud ao sistema de contas do aplicativo.

Parameters

oaid

String: o OAID utilizado pelo sistema de contas do aplicativo.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setCapsule

public MiniAppInitConfig.Builder setCapsule(boolean isCapsule)

Ative os botões cápsula. Ativado por padrão. Este método aplica-se apenas a miniapps uni-app.

Nota

Os botões cápsula exigem a configuração de navigationBar ou titleNView no miniapp uni-app.

Parameters

isCapsule

Boolean: true para exibir, false para ocultar. Padrão: true.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setMenuDefFontColor

public MiniAppInitConfig.Builder setMenuDefFontColor(String menuDefFontColor)

Defina a cor padrão do texto nos botões de menu. Este método aplica-se apenas a miniapps uni-app.

Parameters

menuDefFontColor

String: a cor da fonte. Valores válidos: strings no formato #RRGGBB ou rgba(R,G,B,A). Valor padrão: #000000.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setMenuDefFontSize

public MiniAppInitConfig.Builder setMenuDefFontSize(String menuDefFontSize)

Defina o tamanho padrão da fonte do texto nos botões de menu. Este método aplica-se apenas a miniapps uni-app.

Parameters

menuDefFontSize

String: o tamanho da fonte do texto nos botões de menu. Valores válidos: strings no formato "dígitos+px". Valor padrão: 22px.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setMenuDefFontWeight

public MiniAppInitConfig.Builder setMenuDefFontWeight(String menuDefFontWeight)

Defina a espessura padrão da fonte do texto nos botões de menu. Este método aplica-se apenas a miniapps uni-app.

Parameters

menuDefFontWeight

String: a espessura da fonte do texto nos botões de menu. Valores válidos: normal e bold. Valor padrão: normal.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setMenuActionSheetItems

public MiniAppInitConfig.Builder setMenuActionSheetItems(List<MiniAppMenuActionSheetItem> list)

Defina os botões de menu padrão. Este método aplica-se apenas a miniapps uni-app.

Parameters

list

List<MiniAppMenuActionSheetItem>: uma lista de botões de menu padrão. A configuração só terá efeito se setCapsule estiver definido como true.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setEnableBackground

public MiniAppInitConfig.Builder setEnableBackground(boolean isEnableBackground)

Permite que o miniapp continue em execução em segundo plano após a saída. Este método aplica-se apenas a miniapps uni-app.

Nota

Ativar o modo em segundo plano também exibe a janela de multitarefa. Desative este recurso se o miniapp não precisar de uma janela de tarefa separada. Os recursos de modo em segundo plano e janela de multitarefa são acoplados.

Parameters

isEnableBackground

Boolean: Padrão: false.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setUniMPFromRecents

public MiniAppInitConfig.Builder setUniMPFromRecents(boolean isFromRecents)

Controla a janela de tarefas do miniapp. Visível apenas quando o miniapp está em execução em segundo plano. Este método aplica-se apenas a miniapps uni-app.

Parameters

isFromRecents

Boolean: true para exibir, false para ocultar. A janela de tarefas é exibida apenas quando o miniapp está em execução em segundo plano. Padrão: true.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setCapsuleButtonStyle

public MiniAppInitConfig.Builder setCapsuleButtonStyle(MiniAppCapsuleButtonStyle style)

Defina o estilo do botão cápsula. Este método aplica-se apenas a miniapps uni-app.

Parameters

style

MiniAppCapsuleButtonStyle: o estilo do botão cápsula.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setNJS

public MiniAppInitConfig.Builder setNJS(boolean enable)

Ative o recurso NJS. Desativado por padrão. Este método aplica-se apenas a miniapps uni-app.

Parameters

enable

Boolean: Padrão: false.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setNavigationBarTransparent

public void setNavigationBarTransparent(boolean navigationBarTransparent)

Defina a transparência do fundo da barra de navegação. Apenas para miniapps WindVane.

Parameters

navigationBarTransparent

boolean: true para transparente, false para opaco. Padrão: false. O modo transparente ativa o layout de tela cheia e oculta a barra de status sob a navegação por gestos.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setNavigationBarColorInt

public MiniAppInitConfig.Builder setNavigationBarColorInt(int colorInt)

Defina a cor de fundo da barra de navegação. Apenas para miniapps WindVane.

Parameters

colorInt

int: a cor de fundo da barra de navegação. Padrão: preto.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setNavigationBarDarkIcon

public MiniAppInitConfig.Builder setNavigationBarDarkIcon(boolean darkIcon)

Defina a cor dos ícones da barra de navegação. Apenas para miniapps WindVane.

Parameters

darkIcon

boolean: true para ícones escuros, false para ícones claros.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setNavigationBarWithKitkatEnable

public MiniAppInitConfig.Builder setNavigationBarWithKitkatEnable(boolean navigationBarWithKitkatEnable)

Ative a personalização de cores da barra de navegação em dispositivos Android 4.4 (KitKat). Apenas para miniapps WindVane.

Parameters

navigationBarWithKitkatEnable

boolean: o padrão é true.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setNavigationBarWithEMUI3Enable

public MiniAppInitConfig.Builder setNavigationBarWithEMUI3Enable(boolean navigationBarWithEMUI3Enable)

Ative a personalização de cores da barra de navegação em dispositivos EMUI 3.x. Apenas para miniapps WindVane.

Parameters

navigationBarWithEMUI3Enable

boolean: o padrão é true.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setAppAuthPopStyle

public MiniAppInitConfig.Builder setAppAuthPopStyle(MiniAppAuthPopStyle appAuthPopStyle)

Defina o estilo do pop-up de autorização para chamadas de API de informações do dispositivo. Apenas para miniapps WindVane.

Parameters

MiniAppAuthPopStyle

MiniAppAuthPopStyle: o estilo do pop-up de autorização.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setMiniAppFavoriteStyle

public MiniAppInitConfig.Builder setMiniAppFavoriteStyle(MiniAppFavoriteStyle miniAppFavoriteStyle)

Defina o estilo do pop-up para o menu Mais na barra de navegação. Apenas para miniapps WindVane.

Parameters

MiniAppFavoriteStyle

MiniAppFavoriteStyle: o estilo do menu pop-up.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setNeedAuthFromApp

public MiniAppInitConfig.Builder setNeedAuthFromApp(boolean needAuthFromApp)

Ative a autorização do usuário quando o miniapp chama APIs de informações do dispositivo. (Consulte também Autorização). Apenas para miniapps WindVane.

Parameters

needAuthFromApp

boolean: true para ativar, false para desativar.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setSuperNameSpace

public MiniAppInitConfig.Builder setSuperAppNameSpace(String superNameSpace)

Defina o namespace do objeto window JsApi. Padrão: "window.WindVane". Apenas para miniapps WindVane. Como usar o white label do Mini App JsApi

Parameters

superAppNameSpace

String: o namespace do JsApi.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setJsApiClassNamePrefix

public MiniAppInitConfig.Builder setJsApiClassNamePrefix(String jsApiClassNamePrefix)

Defina o prefixo do nome da classe para chamadas de método JsApi do miniapp. Padrão: window.WindVane. Apenas para miniapps WindVane.Como usar o white label do Mini App JsApi

Parameters

jsApiClassNamePrefix

String: o prefixo do nome da classe JsApi.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

setWindVaneBackwardCompatible

public MiniAppInitConfig.Builder setWindVaneBackwardCompatible(boolean isWindVaneBackwardCompatible) 

Ative a compatibilidade com versões anteriores de window.WindVane.call para métodos JsApi. Padrão: true. Apenas para miniapps WindVane.Como usar o white label do Mini App JsApi

Parameters

isWindVaneBackwardCompatible

boolean: false para desativar, true para ativar. Padrão: true.

Returns

MiniAppInitConfig.Builder

A instância do Builder.

build

public MiniAppInitConfig build()

Constrói o MiniAppInitConfig a partir do estado atual do builder.

Returns

MiniAppInitConfig

A configuração de inicialização do contêiner de miniapp.