{"id":20399534,"url":"https://github.com/appsquickly/backdrop","last_synced_at":"2025-04-12T13:22:42.097Z","repository":{"id":142346886,"uuid":"44081950","full_name":"appsquickly/backdrop","owner":"appsquickly","description":"A utility for configuring iOS and OSX applications for different environments","archived":false,"fork":false,"pushed_at":"2017-05-18T03:57:00.000Z","size":32,"stargazers_count":10,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-26T08:07:13.293Z","etag":null,"topics":["cicd","configuration-management","environments","ios","swift"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/appsquickly.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-10-12T03:25:48.000Z","updated_at":"2021-10-27T08:57:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"40d49142-4676-456b-b1b8-559fe2ee5f0f","html_url":"https://github.com/appsquickly/backdrop","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appsquickly%2Fbackdrop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appsquickly%2Fbackdrop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appsquickly%2Fbackdrop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appsquickly%2Fbackdrop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/appsquickly","download_url":"https://codeload.github.com/appsquickly/backdrop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248572031,"owners_count":21126569,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cicd","configuration-management","environments","ios","swift"],"created_at":"2024-11-15T04:29:46.161Z","updated_at":"2025-04-12T13:22:42.091Z","avatar_url":"https://github.com/appsquickly.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# About\r\n\r\nBackdrop is a utility for configuring an application's Info.plist file for separate environments. It can be used: \r\n\r\n* In dev environments for quickly switching between dev, staging, production environments. \r\n* On continuous integration build servers to automate deployment of pre-configured builds. \r\n\r\n# How Does it Work?\r\n\r\n* We create an \u003ca href=\"https://github.com/appsquickly/backdrop/blob/master/EnvFile.plist\"\u003e`EnvFile.plist`\u003c/a\u003e that declares the properties (icon file, TyphoonConfig, CFBundleID, etc) that will be different between each environment. \r\n* We use a cmd-line utility to apply those configurations. \r\n\r\nOptionally, the cmd-line utility can apply a build number - `CFBundleVersion` - in the format: `\u003cweek_number_since_project_start\u003e.\u003cday_in_week\u003e.\u003cbuild_number_for_day\u003e`\r\n\r\n# Running\r\n\r\nApply the config named 'staging' in the `EnvFile.plist`, and generate a new version number. \r\n\r\n```bash\r\nbackdrop.swift --select staging --newVersion\r\n```\r\n\r\n# Using in CI Environments\r\n\r\nHere's how we do it: \r\n\r\n* Set up a branch for each environment in git, and set up a Jenkins job to monitor for pushes to those branches. \r\n* Exececute the follow script to build and upload to iTunes Connect\r\n\r\n(the script below uses \u003ca href=\"https://github.com/nomad/shenzhen\"\u003eShenzhen\u003c/a\u003e to upload the build)\r\n\r\n```bash\r\n#!/bin/sh\r\n\r\n\r\nproduct_name='AmazingApp'\r\nprovisioning_profile='My Store Profile'\r\n\r\n#Fail immediately if a task fails\r\nset -e\r\nset -o pipefail\r\n\r\necho \"--- Backing up Info.plist ---\"\r\ncp \"./$product_name/Supporting Files/Info.plist\" \"./$product_name/Supporting Files/Info.plist.bak\"\r\n\r\necho \"--- Building ---\"\r\n\r\nrm -fr ./$product_name.ipa\r\nrm -fr ./$product_name.xcarchive/\r\n\r\n./backdrop.swift --select production --newVersion\r\n\r\nxcodebuild -workspace $product_name.xcworkspace/ -scheme $product_name -destination 'generic/platform=iOS' -archivePath \"$product_name.xcarchive\" archive | xcpretty\r\nxcodebuild -exportArchive -exportFormat ipa -archivePath \"$product_name.xcarchive\"  -exportPath \"$product_name.ipa\" -exportProvisioningProfile \"$provisioning_profile\"\r\nipa info $product_name.ipa\r\n\r\necho \"------ Built ------\"\r\nrm \"./$product_name/Supporting Files/Info.plist\"\r\nmv \"./$product_name/Supporting Files/Info.plist.bak\" \"./$product_name/Supporting Files/Info.plist\"\r\n./backdrop.swift\r\n```\r\n\r\n\r\n# Installing\r\n\r\nLater we'll publish to Brew and MacPorts, but for now, \u003ca href=\"https://github.com/appsquickly/backdrop/blob/master/backdrop.swift\"\u003ethis executable Swift script can be used\u003c/a\u003e. \r\n\r\n# TODO\r\n\r\n1. Make backdrop peform the build and upload to iTunes Connect, rather than use the bash script above. \r\n2. Remove the dependency on Shenzhen ipa distribute task. \r\n3. Add generation of debug symbols and tie in to our (or others?) crash reporters\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappsquickly%2Fbackdrop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fappsquickly%2Fbackdrop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappsquickly%2Fbackdrop/lists"}