Biome is a simple way to manage sets of variables between environments you might need to work with when developing your application.
One problem developers face, is the need to create multiple builds in order to test how their application functions in different environments. Biome aims to reduce the amount of re-building that needs to occur, by providing a mechanism to switch configurations during run-time.
Nope. Bi-ohm.
By definition:
noun ECOLOGY
A biome /ˈbaɪoʊm/ is a formation of plants and animals that have common characteristics due to similar climates and can be found over a range of continents.
Applied for our purposes:
A biome is a collection of variables and settings that have common characteristics due to similar environments and can be found across a range of applications.
A manager organizes similarly-typed Biomes into groups, where each group can have at most 1 "active" Biome. You can instruct the BiomeManager to switch to a different Biome within the same BiomeGroup, and the manager notifies the provided delegate.
The smallest conceptual unit in the framework - this object defines a set of properties whose values will be swapped out at any time with a different set of values.
A container that manages similarly-typed Biome objects. A Biome group provides functionality to store Biomes, as well as maintain one "currently active" Biome in that group. You do not need to create or manage groups yourself - the BiomeManager takes care of that automatically.
A common interface to register and track Biome objects.
- Xcode 8.0 / Swift 4.0
- iOS >= 8.0 (Use as an Embedded Framework)
- tvOS >= 9.0
- macOS >= 10.10
BiomeDemo/BiomeDemo.xcodeprojis the demo project for iOS- Make sure you are running a supported version of Xcode.
- Make sure that your project supports Swift 4.0
In order to correctly compile the project:
- Drag the
Biome.xcodeprojto your project - Go to your target's settings, hit the "+" under the "Embedded Binaries" section, and select the Biome.framework
@import Biome- When using Swift in an ObjC project:
- You need to import your Bridging Header. Usually it is "YourProject-Swift.h".
- (Xcode 8.1 and earlier) Under "Build Options", mark "Embedded Content Contains Swift Code"
- (Xcode 8.2+) Under "Build Options", mark "Always Embed Swift Standard Libraries"
Add the following to your Podfile:
pod 'Biome'
and run pod install
Biome includes Carthage prebuilt binaries.
github "ndizazzo/Biome" == 2.0.0
github "ndizazzo/Biome" ~> 2.0.0
In order to build the binaries for a new release, use carthage build --no-skip-current && carthage archive Biome.
To implement Biome, first import Biome into the relevant files where you want to use it.
Then, create a Biome by defining a struct that conforms to the Biome protocol. Add as many fields as you like to your object, and implement the keyCount property to return the number of properties on the object.
Once you have Biome objects, use BiomeManager.register(...) to register them. This does a couple things:
- Adds it to a managed group of similarly-typed Biomes. One uniquely identified Biome is allowed per group.
- Sets it as the
currentBiome of theBiomeGroupmanaging it. Thiscurrentproperty tells you which Biome is currently active.
Finally, extend one of your classes to receive events when the Biome is switched:
extension MyClass: BiomeManagerDelegate {
func switched(to biome: Biome?) {
print("The active biome has been switched to '\(to.name)'")
}
}Use that delegate method to do anything: clear a database and reload data into it from a different environment, re-query an API for new data, refresh a view controller's appearance, etc.
- SR-7897 suggests that synthesized
Codableconformance should also optionally generateCaseIterableconformance. This would allow everyBiometo have thekeyCountautomatically generated, andallItemsreflect the actual properties of the Biome.
If this improvement moves to the proposal phase, Biome.framework could add support for it, allowing developers to do more powerful things with the library; where they might be listed out for display in some type of UICollectionView / UITableView.
- Sometimes a developer might need to modify a property at run-time instead of providing it before compile-time. This feature would allow developers to do things like tweak animation timings, for instance.
- Please note the difference between installing a compiled framework from CocoaPods or Carthage, and copying the source code.
- Please re-read the usage section.
- Search issues.
- Politely ask in the issues section.
- Search issues.
- Politely ask in the issues section.
Biome does not depend on any 3rd party libraries. It's designed to be lightweight and not add tons of overhead to your project.
If you have ideas or like what you see here and want to support the project, you could:
- Let people know this library exists (🚀 spread the word 🚀)
- Contribute code, issues and pull requests
If you are having questions or problems, you should:
- Make sure you are using the latest version of the library. Check the release-section.
- Search or open questions on stackoverflow with the
ios-biometag - Search known issues for your problem (open and closed)
- Create new issues (please search known issues beforehand and avoid creating duplicate issues)
Documentation exists in the form of Xcode quick-help. Please refer to Apple's Documentation for writing quick help documentation.
Or you can study the BiomeDemo project to learn by example.
Biome is available under the MIT license. See the LICENSE file for more information.