https://github.com/rolemodel/rmshostselector
Manages server selection for iOS apps
https://github.com/rolemodel/rmshostselector
Last synced: over 1 year ago
JSON representation
Manages server selection for iOS apps
- Host: GitHub
- URL: https://github.com/rolemodel/rmshostselector
- Owner: RoleModel
- License: mit
- Created: 2013-10-16T22:02:41.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2014-06-04T03:31:12.000Z (about 12 years ago)
- Last Synced: 2025-02-06T00:35:08.645Z (over 1 year ago)
- Language: Objective-C
- Size: 420 KB
- Stars: 2
- Watchers: 25
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
RMSHostSelector
===============
Manages server selection for iOS apps
Use `RMSHostSelector` to allow user-selection of a server host when
testing/debugging iOS apps. Host choices are defined in a Hosts.plist
file that you add to your app's resources. Each host is defined as a
key/value pair (i.e. production => myserver.com)
Release builds should not permit user-selection of a back-end server.
For these builds, preference is given to the `production` key in the
Hosts.plist file. All other keys will be stripped out of the bundled
Hosts.plist file and the user will not be prompted for server selection.
The special handling is performed by the `host_selector_build_phase.sh`
that must be added as a "Run Script" build phase in order to take
effect.
A key other than `production` can be coerced by defining the
`RMS_HOST_KEY` preprocessor macro. The value specified by this key must
be quoted and must match one of the keys in the Hosts.plist file.
Non-release builds can also make use of the `RMS_HOST_KEY` override. For
non-release builds where `RMS_HOST_KEY` is defined, the Hosts.plist file
is left in tact, but user-selection of the host is circumvented.
Custom Build Phase
------------------
Once you've installed this CocoaPod, you'll need to set up a custom
build phase to incorporate `host_selector_build_phase.sh` into your
project. Do this by navigating to the application target in Xcode
and selecting *Add Build Phase -> Add Run Script Build Phase* from the
*Editor* menu.
Then, in the shell script entry area for the newly
added run build phase enter the following:
`"${SRCROOT}"/Pods/RMSHostSelector/Resources/host_selector_build_phase.sh`
That's all you need to do to get the default behavior, provided that
your `Hosts.plist` file contains an entry for the `production` host.
