The Firebase Remote Config iOS quickstart app demonstrates using Remote Config to define user-facing text in an iOS app.
This is a simple example of using Remote Config to override in-app default values by defining service-side parameter values in the Firebase console. This example demonstrates a small subset of the capabilities of Firebase Remote Config. To learn more about how you can use Firebase Remote Config in your app, see Firebase Remote Config Introduction.
- Add Firebase to your iOS Project.
- Create a Remote Config project for the quickstart sample, defining the parameter values and parameter keys used by the sample.
- Run the sample on an iOS device or emulator.
- Change one or more parameter values in the Firebase Console (the value of
welcome_message,welcome_message_caps, or both). - Tap Fetch Remote Config in the app to fetch new parameter values and see the resulting change in the app.
This section provides some additional information about how the quickstart example sets in-app default parameter values and fetches values from the Remote Config service.
In-app default values are set using a plist file with the
setDefaultsFromPlistFileName method in this example, but you can also set
in-app default values inline using the other setDefaults methods of the
FIRRemoteConfig class.
Then, you can override only those values that you need to change from the Firebase console. This lets you use Remote Config for any default value that you might want to override in the future, without the need to set all of those values in the Firebase console.
When an app calls fetchWithExpirationDuration:completionHandler, updated
parameter values are fetched from the Remote Config service if either
- the last successful fetch occurred more than 12 hours ago, or
- a value less than 43200 (the number of seconds in 12 hours) is specified for
TimeInterval.
Otherwise, cached parameter values are used.
Fetched values are cached locally, but not immediately activated. To activate
fetched values so that they take effect, call the activateFetched method. In
the quickstart sample app, you call this method from the UI by tapping
Fetch Remote Config.
You can also create a Remote Config Setting to enable developer mode, but you must remove this setting before distributing your app. Fetching Remote Config data from the service is normally limited to a few requests per hour. By enabling developer mode, you can make many more requests per hour, so you can test your app with different Remote Config parameter values during development.
- To learn more about fetching data from Remote Config, see the Remote Config Frequently Asked Question (FAQ) on fetching and activating parameter values.
- To learn about parameters and conditions that you can use to change the behavior and appearance of your app for segments of your userbase, see Remote Config Parameters and Conditions.
- To learn more about the Remote Config API, see Remote Config API Overview.
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.