A configuração de switches altera dinamicamente a lógica do código no lado do cliente sem exigir uma nova versão do aplicativo. O cliente obtém os valores dos switches do backend para controlar seu comportamento. Cada switch é um par chave-valor configurável, modificável e publicável por meio do serviço de configuração de switches.
O mPaaS oferece o serviço de gerenciamento de configurações (ConfigService) para a configuração de switches. Por padrão, o cliente busca as configurações durante uma inicialização a frio. Ele também as busca quando o aplicativo retorna ao primeiro plano, caso mais de 30 minutos tenham se passado desde a última busca. O ConfigService ainda fornece uma API para buscas imediatas e um listener para detectar alterações, garantindo a atualização rápida das configurações.
Para usar a configuração de switches, adicione o SDK do iOS, configure seu projeto e leia as configurações.
A configuração de switches chama as APIs de atualização e publicação do Mobile Delivery Service (MDS), o que gera cobranças. Para obter mais informações sobre faturamento, consulte a seção de publicação em tempo real em Preços.
Pré-requisitos
Integre seu projeto ao mPaaS. Para obter mais informações, consulte:
Pré-requisitos
Integre seu projeto ao mPaaS. Para obter mais informações, consulte Conexão com um projeto existente usando CocoaPods.
Sobre esta tarefa
Este tópico utiliza o exemplo de código de configuração de switches para ilustrar o processo.
Adicionar o SDK
Escolha o método correspondente ao seu tipo de conexão.
Usar o plug-in mPaaS Xcode Extension
Este método destina-se a projetos que utilizam o tipo de conexão Connect based on the mPaaS framework ou Connect to an existing project using the mPaaS plug-in.
Na barra de menus do Xcode, escolha Editor > mPaaS > Edit Project para abrir a página de edição do projeto.
-
Selecione Switch Configuration, salve a alteração e clique em Start Editing para adicionar o componente.
Usar o plug-in cocoapods-mPaaS
Utilize este método para projetos com o tipo de conexão Connect to an existing project using CocoaPods.
No Podfile, adicione a dependência
mPaaS_pod "mPaaS_Config"referente ao componente de gerenciamento de configurações.
Consulte o guia de uso do CocoaPods e execute
pod installoupod updateconforme necessário para concluir a integração.
Adicionar o SDK
Use o plug-in cocoapods-mPaaS para adicionar o SDK.
Siga estas etapas:
No Podfile, adicione a dependência
mPaaS_pod "mPaaS_Config"para o componente de configuração de switches.Consulte o Guia de Uso do CocoaPods e execute
pod installoupod updateconforme necessário para finalizar a integração.
Configure o projeto
Esta etapa é necessária apenas para a versão 10.1.32. Pule esta etapa nas versões 10.1.60 e 10.1.68, pois a configuração do projeto já está integrada nativamente.
O mPaaS encapsula a configuração de switches como um serviço. Registre o serviço no gerenciador de serviços antes de usá-lo, conforme mostrado no exemplo de código a seguir.
Ler a configuração
Publique dinamicamente valores para chaves de switches no console do mPaaS. No painel de navegação, escolha Real-time Release > Configuration Management > Configuration Key para visualizar os detalhes.
Próximas etapas
Obter valores de switches
No console do mPaaS, acesse Real-time Release > Configuration Management para adicionar itens de configuração. Envie configurações com base em critérios como plataforma, lista de permissões, porcentagem, número da versão, modelo do dispositivo e versão do iOS. Para obter mais informações, consulte Gerenciamento de Configurações Android/iOS.
Após publicar uma chave de switch no console, chame uma API no cliente para recuperar seu valor.
+ (void)testStringForKey
{
id<APConfigService>configService = [DTContextGet() findServiceByName:@"APConfigService"];
NSString *configValue = [configService stringValueForKey:@"BillEntrance"];
assert (configValue && [configValue isKindOfClass:[NSString class]]);
}Os valores das chaves de switches são retornados por uma busca via chamada de procedimento remoto (RPC), que pode falhar. Implemente uma lógica local no cliente para lidar com falhas na busca. Recomendamos definir um valor padrão para o switch na lógica local do cliente. Quando um novo switch é publicado no console, o cliente usa a nova configuração. Se a busca falhar, o cliente reverte para a lógica padrão local.
Guia avançado
-
Momentos em que o cliente busca configurações de switches:
Uma inicialização a frio do aplicativo aciona uma busca.
-
Ao retornar ao primeiro plano, o cliente busca as configurações novamente se mais de 30 minutos tiverem passado desde a última busca.
NotaO intervalo padrão é de 30 minutos. Para alterar esse intervalo, adicione o switch
Load_Config_Intervalna página Real-time Release > Switch Configuration Management no console. Para obter mais informações, consulte Gerenciamento de Configurações Android/iOS.
-
Escuta dinâmica de alterações em switches
Adicione um observer a uma chave específica para monitorar dinamicamente as alterações no valor do switch.
Quando o cliente buscar a configuração do switch, recupere o valor mais recente da chave especificada no método de callback.
Forçar a busca de valores de switches: O SDK fornece um método para forçar uma busca imediata das configurações mais recentes no console.
