Skip to main content

Flagsmith iOS SDK

This library can be used with iOS and Mac applications. The source code for the client is available on Github.

Installation#

CocoaPods#

CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate Flagsmith into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'FlagsmithClient', '~> 1.0'

Basic Usage#

The SDK is initialised against a single environment within a project on https://flagsmith.com, for example the Development or Production environment. You can find your environment key in the Environment settings page.

Image

Initialization#

Within your application delegate (usually AppDelegate.swift) add:

import FlagsmithClient
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
Flagsmith.shared.apiKey = "<YOUR_API_KEY>"// The rest of your launch method code}

Now you are all set to retrieve feature flags from your project. For example to list and print all flags:

Flagsmith.shared.getFeatureFlags() { (result) in    switch result {    case .success(let flags):        for flag in flags {            let name = flag.feature.name            let value = flag.value?.stringValue            let enabled = flag.enabled            print(name, "= enabled:", enabled, "value:", value ?? "nil")        }    case .failure(let error):        print(error)    }}

Note that you can use:

  • flag.value?.stringValue
  • flag.value?.intValue
  • flag.value?.floatValue

Based on your desired type.

To retrieve a feature flag boolean value by its name:

Flagsmith.shared.hasFeatureFlag(withID: "test_feature1", forIdentity: nil) { (result) in    print(result)}

To retrieve a config value by its name:

Flagsmith.shared.getFeatureValue(withID: "test_feature2", forIdentity: nil) { (result) in    switch result {    case .success(let value):        print(value ?? "nil")    case .failure(let error):        print(error)    }}

These methods can also specify a particular identity to retrieve the values for a user registration. See Identities , using the forIdentity parameter.

To retrieve a trait for a particular identity (see Traits):

Flagsmith.shared.getTraits(forIdentity: "test_user@test.com") {(result) in    switch result {    case .success(let traits):        for trait in traits {            let name = trait.key            let value = trait.value            print(name, "=", value)        }    case .failure(let error):        print(error)    }}