获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Primeiros passos com o Configuração remota do Firebase


Você pode usar o Firebase Remote Config para definir parâmetros em seu aplicativo e atualizar seus valores na nuvem, permitindo que você modifique a aparência e o comportamento de seu aplicativo sem distribuir uma atualização de aplicativo.

A biblioteca do Remote Config é usada para armazenar valores de parâmetros padrão no aplicativo, buscar valores de parâmetros atualizados do back-end do Remote Config e controlar quando os valores buscados são disponibilizados para seu aplicativo. Para saber mais, consulte Estratégias de carregamento do Configuração remota .

Este guia orienta você pelas etapas para começar e fornece alguns códigos de amostra, todos disponíveis para clonar ou baixar no repositório GitHub firebase/quickstart-unity .

Etapa 1: adicionar configuração remota ao seu aplicativo

Antes de poder usar o Remote Config , você precisa:

  • Registre seu projeto Unity e configure-o para usar o Firebase.

    • Se o seu projeto Unity já usa o Firebase, ele já está registrado e configurado para o Firebase.

    • Se você não tiver um projeto Unity, poderá baixar um aplicativo de exemplo .

  • Adicione o Firebase Unity SDK (especificamente, FirebaseRemoteConfig.unitypackage ) ao seu projeto Unity.

Observe que adicionar o Firebase ao seu projeto do Unity envolve tarefas no console do Firebase e em seu projeto Unity aberto (por exemplo, você baixa os arquivos de configuração do Firebase do console e os move para o seu projeto do Unity).

Etapa 2: definir valores de parâmetro padrão no aplicativo

Você pode definir valores de parâmetro padrão no aplicativo no objeto Remote Config, para que seu aplicativo se comporte como pretendido antes de se conectar ao back-end do Remote Config e para que os valores padrão estejam disponíveis se nenhum for definido no back-end.

Para fazer isso, crie um dicionário de strings e preencha-o com pares chave/valor que representam os padrões que você deseja adicionar. Se você já configurou os valores dos parâmetros de back-end do Configuração remota, pode fazer download de um arquivo que contém esses pares chave/valor e usá-lo para construir seu dicionário de strings. Para obter mais informações, consulte Baixar padrões de modelo do Configuração remota .

(As propriedades não string serão convertidas no tipo da propriedade quando SetDefaultsAsync() for chamado).

System.Collections.Generic.Dictionary<string, object> defaults =
  new System.Collections.Generic.Dictionary<string, object>();

// These are the values that are used if we haven't fetched data from the
// server
// yet, or if we ask for values that the server doesn't have:
defaults.Add("config_test_string", "default local string");
defaults.Add("config_test_int", 1);
defaults.Add("config_test_float", 1.0);
defaults.Add("config_test_bool", false);

Firebase.RemoteConfig.FirebaseRemoteConfig.DefaultInstance.SetDefaultsAsync(defaults)
  .ContinueWithOnMainThread(task => {

Etapa 3: obter valores de parâmetro para usar em seu aplicativo

Agora você pode obter valores de parâmetro do objeto Remote Config. Se você definir valores no back-end do Configuração remota, buscá-los e depois ativá-los, esses valores estarão disponíveis para seu aplicativo. Caso contrário, você obtém os valores de parâmetro no aplicativo configurados usando SetDefaultsAsync() .

Para obter esses valores, use GetValue() , fornecendo a chave do parâmetro como argumento. Isso retorna um ConfigValue , que possui propriedades para converter o valor em vários tipos básicos.

Etapa 4: conectar seu aplicativo no Firebase console

No console do Firebase , adicione seu aplicativo ao seu projeto do Firebase.

Etapa 5: definir valores de parâmetro

  1. No console do Firebase , abra seu projeto.
  2. Selecione Remote Config no menu para visualizar o painel Remote Config.
  3. Defina parâmetros com os mesmos nomes dos parâmetros que você definiu em seu aplicativo. Para cada parâmetro, você pode definir um valor padrão (que eventualmente substituirá o valor padrão do aplicativo) e valores condicionais. Para saber mais, consulte Parâmetros e condições do Configuração remota .

Etapa 6: buscar e ativar valores (conforme necessário)

Para buscar valores de parâmetro do back-end do Remote Config, chame o método FetchAsync() . Quaisquer valores que você definir no back-end são buscados e armazenados em cache no objeto Remote Config.

// Start a fetch request.
// FetchAsync only fetches new data if the current data is older than the provided
// timespan.  Otherwise it assumes the data is "recent enough", and does nothing.
// By default the timespan is 12 hours, and for production apps, this is a good
// number. For this example though, it's set to a timespan of zero, so that
// changes in the console will always show up immediately.
public Task FetchDataAsync() {
  DebugLog("Fetching data...");
  System.Threading.Tasks.Task fetchTask =
  Firebase.RemoteConfig.FirebaseRemoteConfig.DefaultInstance.FetchAsync(
      TimeSpan.Zero);
  return fetchTask.ContinueWithOnMainThread(FetchComplete);
}

Os valores buscados por meio FetchAsync() são armazenados em cache localmente quando a busca é concluída, mas não são disponibilizados até que ActivateFetched() seja invocado. Como FetchAsync() é executado de forma assíncrona, isso permite garantir que os novos valores não sejam aplicados no meio do cálculo ou em outros momentos que possam causar problemas ou comportamento estranho.

Etapa 7: (opcional) ativar o modo de desenvolvedor

Para habilitar o modo de desenvolvedor, que pode ser usado para desabilitar a limitação durante o desenvolvimento, você pode usar a propriedade FirebaseRemoteConfig.Setting , definindo um novo ConfigSettings com IsDeveloperMode definido como true.

Next steps

If you haven't already, explore the Remote Config use cases , and take a look at some of the key concepts and advanced strategies documentation, including: