unlimit 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42cbe91c40dae996ebf366b44f131e5df346e8d8e3f8ad1820565af314413d78
-  data.tar.gz: 644cde5212c4efeae10b50380fc3776d20882aacfa42140f9b64e6f5e84cbfb3
+  metadata.gz: 864ee31974d738b3a807e9dfc681453675c8076f9e99b5e92dc8996d7b14f115
+  data.tar.gz: b6de9ff30673b7f7ee0ba00d9bb913c2192e7f6891cd39830fcf6874a6f110dd
 SHA512:
-  metadata.gz: e711fff69333c8c8fd4cfe6304eacb24c7e590ff3155a08a9e530d10c8019e067562178ca0152d542e3421e8a7fab3640b1648719e6722484d3dc94f86f641b8
-  data.tar.gz: 630c7bbcf52f10ef5a5b650b416e02f18a13958114d82f7cd7611c57bb6c6ff07da7191188a40fb56e5778e144f0af68a98d9e9107d597ee0883ca08425fab5e
+  metadata.gz: dacc6bbd3d729b9ead635d2f09ce7ffc0832f65534ccc7aba0954f285b62fdf8b9ea6887372f7767c042784853daa007ec5ea44386f7503d2bfc78f105bbcfc5
+  data.tar.gz: 6aa08686cd9bbeeefdaf74e1c2294671c07e1002493c5cf632d67010fc37eafa3041c8b2624a953aa125c17a7efb54dd23f8ad54a6a3fc4a0764a90abc941639

data/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Change Log
+
+
+## [0.0.2](https://github.com/biocross/unlimit/releases/tag/0.0.2)
+Released on 2019-08-15.
+
+#### Added
+- Unlimit can now autodetect your Personal Team ID, or an interactive selection when it's unsure
+- Automatically generates a unique App Group linked to your Bundle ID, and activates app groups if they are being used in the project.
+- Automatically disables Fabric build phase script to avoid the annoying `New App ID added successfully` emails. This can be disabled using the `--keep_fabric` flag.
+- Added `--team_id` flag to set signing team ID manually
+- Added `--version` flag to check unlimit version
+
+### Fixed
+- Only remove App Extensions if they exist
+- Don't disable `SafariKeychain` Capability because it doesn't affect signing
+
+## [0.0.1](https://github.com/biocross/unlimit/releases/tag/0.0.1)
+Released on 2019-07-26.
+
+#### Added
+- Initial release 🎉

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    unlimit (0.0.1)
+    unlimit (0.0.2)
       configure_extensions
       fastlane
       plist
@@ -45,7 +45,7 @@ GEM
     faraday_middleware (0.13.1)
       faraday (>= 0.7.4, < 1.0)
     fastimage (2.1.5)
-    fastlane (2.128.0)
+    fastlane (2.128.1)
       CFPropertyList (>= 2.3, < 4.0.0)
       addressable (>= 2.3, < 3.0.0)
       babosa (>= 1.0.2, < 2.0.0)

data/README.md

@@ -1,18 +1,20 @@
 # Unlimit 🚀📲
 
-Unlimit is a simple tool to quickly run your app on your device without worrying about the 100 device limit per developer account set by Apple. It achieves this by **temporarily switching your Xcode Project to the `Personal Team`**.
+Unlimit is a simple tool to quickly run your app on your device without worrying about the 100 device limit per developer account set by Apple. It achieves this by temporarily switching your Xcode Project to your [free](https://github.com/biocross/unlimit#do-i-require-a-paid-apple-developer-account-to-use-this) personal team (`Personal Team`).
 
 > In a nutsell, unlimit fixes this:
 
 <img width="350" src="https://github.com/biocross/unlimit/raw/master/images/max_devices.png" alt="Xcode Device Limit Reached Error">
 
+**Note that all changes unlimit makes to your project are local on your mac, and do not in anyway affect the configuration on your Apple Developer Portal.**
+
 ### Why can't I just do it myself?
 
 Well, you can, if your project is simple. However, if your project has capabilities like **Push Notifications**, **Background Modes** & **App Extensions**, things get complicated, since these require you to configure your `Personal Team` with all these entitlements. Unlimit gets rid of all this mess, and gets you quickly up and running on your device.
 
 ### What's the catch?
 
-Well, since unlimit temporarily removes capabilities like **App Extensions, Push Notifications** & more from your project, you **can't** test these features on your device when using your personal team.
+Well, since unlimit temporarily removes capabilities like **App Extensions, Push Notifications** & more from your project, you **cannot** test these features on your device when using your personal team.
 
 ### How do I undo unlimit's changes?
 
@@ -20,37 +22,54 @@ We recommend you run unlimit when you have no staged changes, so that you can si
 
 ## Installation
 
-Add this line to your application's Gemfile:
+If your iOS/Mac project does not have a `Gemfile` yet, [learn how to set it up here](https://www.mokacoding.com/blog/ruby-for-ios-developers-bundler/). It's highly recommended you use [**bundler**](https://bundler.io/) to maintain consistent versions of tools like `cocoapods`, `fastlane` etc within your team. 
+
+To use unlimit, add this line to your app's Gemfile:
 
 ```ruby
 gem 'unlimit'
 ```
 
-And then execute:
-
-    $ bundle install && bundle exec unlimit
+And then install it using [bundler](https://bundler.io/) by executing:
 
-Or install it yourself as:
+    $ bundle install
 
-    $ gem install unlimit
 
 ## Usage
 
-Just execute:
+After installing the gem, just run:
 
     $ bundle exec unlimit
 
 and unlimit will do it's magic.
 
-## Development
+## Parameters
+All these parameters are optional, as unlimit can **autodetect** most of these. You can use these when unlimit is unable to figure them out, or to pass in overrides.
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+| Parameter | Description | Example |
+| --- | --- | --- |
+| `project` | The **.xcodeproj** project file to use | `--project MyApp.xcodeproj` |
+| `target`  | The **app target** you want to run on your device | `--target MyApp` |
+| `plist`   | The **path** to your app's **Info.plist** file | `--plist MyApp/MyApp-Info.plist` |
+| `team_id`   | The Code Signing **Team ID** to use | `--team_id A1B2C3D4E5A` |
+| `keep_fabric`   | Unlimit automatically disables Fabric's build phase script, to avoid the annoying `New app ID added` email sent by Fabric. Use this flag for keep the Fabric script. (Note: This does not affect Fabric/Crashlytics functionality, only disables it's dSYM uploading shell script) | `--keep_fabric` |
+| `version`   | Print the current unlimit version you're using and exit | `--version` |
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/biocross/unlimit
+Bug reports and pull requests are welcome. Any feedback or feature suggesions are also encouraged.
+
+## More FAQs
+
+### Do I require a paid apple developer account to use this?
+
+No, you can get a `personal team` using a free Apple Developer Account, since Apple now allows testing on device with a free developer accounts as well. As apple puts it: 
+
+> Xcode 7 and Xcode 8 allow you to select the free personal team provided with your Apple ID for signing your app. This team allows you to build apps for your personal use on devices owned by you, but it does not allow you to code sign apps destined for the App Store or for enterprise use.
+
+>You can identify this account by looking in the accounts tab of the Xcode preferences. It is also displayed in the team menu displayed in a target's general build settings. Your personal account will be the account with the string '(Personal Team)' beside the name.
+
+Source: https://developer.apple.com/library/archive/qa/qa1915/_index.html
 
 ## License
 

data/bin/unlimit

@@ -1,14 +1,19 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require 'unlimit'
 require 'optparse'
 
+unlimiter = Unlimit::CLI.new
 options = {}
+
 OptionParser.new do |opt|
   opt.on('--project XCODEPROJ') { |o| options['project_path'] = o }
   opt.on('--plist INFO_PLIST') { |o| options['plist_path'] = o }
   opt.on('--target TARGET_NAME') { |o| options['target_name'] = o }
+  opt.on('--team_id TEAM_ID') { |o| options['team_id'] = o }
+  opt.on('--keep_fabric') { |_o| options['keep_fabric'] = true }
+  opt.on('--version') { unlimiter.showVersion }
 end.parse!
 
-unlimiter = Unlimit::CLI.new
-unlimiter.start(options)
+unlimiter.start(options)

data/lib/unlimit.rb

@@ -5,12 +5,19 @@ require 'xcodeproj'
 require 'securerandom'
 require 'json'
 require 'plist'
+require 'open3'
+require 'highline'
 
 ProjectPathKey = 'project_path'
 PlistPathKey = 'plist_path'
 TargetNameKey = 'target_name'
+TeamIDKey = 'team_id'
+KeepFabricKey = 'keep_fabric'
 InfoPlistBuildSettingKey = 'INFOPLIST_FILE'
 ProductTypeApplicationTarget = 'com.apple.product-type.application'
+FastlaneEnvironmentVariables = 'LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 FASTLANE_SKIP_UPDATE_CHECK=true'
+CapabilitiesWhitelist = ['com.apple.SafariKeychain'].freeze
+FastFilePath = 'fastlane/Fastfile'
 Divider = '================================================'
 
 module Unlimit
@@ -19,9 +26,17 @@ module Unlimit
       puts "Using #{parameter}: #{value}".green + " (Use flag --#{flag} to override)".yellow
     end
 
+    def showVersion
+      puts Divider
+      puts "You're using unlimit version #{Unlimit::VERSION}".green
+      puts 'https://github.com/biocross/unlimit'.yellow
+      puts Divider
+      abort
+    end
+
     def start(options)
       puts Divider
-      puts '                  unlimit 🚀📲                  '
+      puts "            unlimit 🚀📲 (#{Unlimit::VERSION})       "
       puts '    Switching your project to Personal Team!    '.yellow
       puts Divider
 
@@ -29,9 +44,14 @@ module Unlimit
       project_path = ''
       plist_path = ''
       target_name = ''
+      personal_team_id = ''
+      uses_app_groups = false
+      entitlements_file = ''
       extensions = []
       target = nil
 
+      cli = HighLine.new
+
       # Check for a valid xcode_project
       if xcode_project_files.count == 1 || options.key?(ProjectPathKey)
         project_path = if options.key?(ProjectPathKey)
@@ -58,9 +78,19 @@ module Unlimit
       else
         project.targets.each do |current_target|
           next unless current_target.product_type == ProductTypeApplicationTarget
+
           target = current_target
           target_name = current_target.name
           putsWithOverrides('target', target_name, TargetNameKey)
+
+          # Remove Fabric Script build phase to stop the annoying "new app" email
+          unless options.key?(KeepFabricKey)
+            current_target.build_phases.each do |build_phase|
+              next unless build_phase.is_a?(Xcodeproj::Project::Object::PBXShellScriptBuildPhase) && build_phase.shell_script.include?('/Fabric/run')
+
+              build_phase.shell_script = '#' + build_phase.shell_script
+            end
+          end
           break
         end
       end
@@ -90,6 +120,41 @@ module Unlimit
         end
       end
 
+      if options.key?(TeamIDKey)
+        personal_team_id = options[TeamIDKey]
+        putsWithOverrides('Team ID', personal_team_id, TeamIDKey)
+      else
+        valid_codesigning_identities, stderr, status = Open3.capture3('security find-identity -p codesigning -v')
+        personal_teams = valid_codesigning_identities.scan(/\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}\b/i)
+        if personal_teams.size == 1
+          personal_team_name = personal_teams.first.strip
+          personal_team_id, stderr, status = Open3.capture3("security find-certificate -c #{personal_team_name} -p | openssl x509 -text | grep -o OU=[^,]* | grep -v Apple | sed s/OU=//g")
+          personal_team_id = personal_team_id.strip
+          putsWithOverrides("Team ID (from: #{personal_team_name})", personal_team_id, TeamIDKey)
+        else
+          puts "\nYou have quite a few developer identities on your machine. unlimit is unable to decide which one to use 😅".yellow
+          puts 'If you know the Team ID to use, pass it with the --teamid flag like --teamid 6A2T6455Y3'.yellow
+          puts "\nFor now, choose one from the list below: (The one most likely to work will have your email)".yellow
+          puts 'Which codesigning identity should unlimit use?'.green
+          selected_team = ''
+          codesigning_options = valid_codesigning_identities.split("\n")
+          codesigning_options = codesigning_options.select { |line| line.include?(')') }
+          codesigning_options = codesigning_options.map { |identity| identity.scan(/\d+\) (.+)/).first.first }
+          cli.choose do |menu|
+            menu.prompt = 'Select one by entering the number: '
+            codesigning_options.each do |identity|
+              menu.choice(identity) { cli.say(identity); selected_team = identity }
+            end
+          end
+
+          personal_team = selected_team.scan(/\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}\b/i)
+          personal_team_name = personal_team.first.strip
+          personal_team_id, stderr, status = Open3.capture3("security find-certificate -c #{personal_team_name} -p | openssl x509 -text | grep -o OU=[^,]* | grep -v Apple | sed s/OU=//g")
+          personal_team_id = personal_team_id.strip
+          putsWithOverrides("Team ID (from: #{personal_team_name})", personal_team_id, TeamIDKey)
+        end
+      end
+
       puts "================================================\n"
 
       # Turn off capabilities that require entitlements
@@ -103,7 +168,13 @@ module Unlimit
 
           capabilities = val['SystemCapabilities']
           capabilities.each do |key, val|
-            if val.key?('enabled')
+            next unless val.key?('enabled')
+
+            if key.include?('com.apple.ApplicationGroups.iOS')
+              uses_app_groups = true
+            end
+
+            unless CapabilitiesWhitelist.include?(key)
               puts ' Turning OFF ' + key
               capabilities[key]['enabled'] = '0'
             end
@@ -115,8 +186,9 @@ module Unlimit
       # Remove Entitlements
       puts 'Clearing entitlements...'.red
       Dir.glob('**/*.entitlements').each do |source_file|
-        empty_plist = {}.to_plist
-        File.open(source_file, 'w') { |file| file.puts empty_plist }
+        entitlements_plist = uses_app_groups ? { "com.apple.security.application-groups": '' }.to_plist : {}.to_plist
+        entitlements_file = source_file if uses_app_groups
+        File.open(source_file, 'w') { |file| file.puts entitlements_plist }
       end
 
       # Remove Capability Keys from Plist
@@ -128,17 +200,41 @@ module Unlimit
       # Change Bundle Identifier
       puts 'Changing bundle identifier...'.red
       bundle_identifier = "com.unlimit.#{SecureRandom.uuid}"
-      system("bundle exec fastlane run update_app_identifier plist_path:#{plist_path} app_identifier:#{bundle_identifier}")
+      system("#{FastlaneEnvironmentVariables} bundle exec fastlane run update_app_identifier plist_path:#{plist_path} app_identifier:#{bundle_identifier}")
+
+      if uses_app_groups # Create a temporary fastfile, and set the app group identifiers
+        fastfile = "lane :set_app_group do
+        update_app_group_identifiers(entitlements_file: \"#{entitlements_file}\", app_group_identifiers: ['group.#{bundle_identifier}'])
+        end"
+
+        existingFastfile = ''
+        if File.file?(FastFilePath)
+          File.open('./fastlane/Fastfile', 'r') do |file|
+            existingFastfile = file.read
+          end
+        end
+        File.open(FastFilePath, 'w') do |file|
+          file.write(fastfile)
+        end
+        system("#{FastlaneEnvironmentVariables} bundle exec fastlane set_app_group")
+        existingFastfile.empty? ? File.delete(FastFilePath) : File.open('./fastlane/Fastfile', 'w') { |file| file.write(existingFastfile) }
+      end
 
       puts 'Enabling Automatic Code Signing...'.red
-      system("bundle exec fastlane run automatic_code_signing use_automatic_signing:true targets:#{target_name}")
+      system("#{FastlaneEnvironmentVariables} bundle exec fastlane run automatic_code_signing use_automatic_signing:true targets:#{target_name}")
+
+      puts 'Switching to Personal Team...'.red
+      system("#{FastlaneEnvironmentVariables} bundle exec fastlane run update_project_team teamid:\"#{personal_team_id}\" targets:#{target_name}")
 
       # Remove App Extensions
-      puts "Removing App Extensions: #{extensions.join(', ')}".red
-      system("bundle exec configure_extensions remove #{project_path} #{target_name} #{extensions.join(' ')}")
+      unless extensions.empty?
+        app_extensions = extensions.join(', ')
+        puts "Removing App Extensions: #{app_extensions}".red
+        system("bundle exec configure_extensions remove #{project_path} #{target_name} #{app_extensions}")
+      end
 
       puts "\n#{Divider}"
-      puts 'You\'re good to go! Just connect your device, switch to your \'Personal Team\', and hit run!'.green
+      puts 'You\'re good to go! Just connect your device and hit run!'.green
       puts Divider
     end
   end

data/lib/unlimit/version.rb

@@ -1,3 +1,3 @@
 module Unlimit
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/unlimit.gemspec

@@ -1,43 +1,45 @@
+# frozen_string_literal: true
 
-lib = File.expand_path("../lib", __FILE__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "unlimit/version"
+require 'unlimit/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "unlimit"
+  spec.name          = 'unlimit'
   spec.version       = Unlimit::VERSION
-  spec.authors       = ["Siddharth Gupta"]
-  spec.email         = ["sids.1992@gmail.com"]
+  spec.authors       = ['Siddharth Gupta']
+  spec.email         = ['sids.1992@gmail.com']
 
-  spec.summary       = "Test your iOS projects on device despite the 100 device limit"
-  spec.description   = "Test your iOS projects on device despite the 100 device limit, by automatically switching to your personal team"
-  spec.homepage      = "https://github.com/biocross/unlimit"
-  spec.license       = "MIT"
+  spec.summary       = 'Test your iOS projects on device despite the 100 device limit'
+  spec.description   = 'Test your iOS projects on device despite the 100 device limit, by automatically switching to your personal team'
+  spec.homepage      = 'https://github.com/biocross/unlimit'
+  spec.license       = 'MIT'
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
   # to allow pushing to a single host or delete this section to allow pushing to any host.
   if spec.respond_to?(:metadata)
-    spec.metadata["homepage_uri"] = spec.homepage
-    spec.metadata["source_code_uri"] = "https://github.com/biocross/unlimit"
-    spec.metadata["changelog_uri"] = "https://github.com/biocross/unlimit"
+    spec.metadata['homepage_uri'] = spec.homepage
+    spec.metadata['source_code_uri'] = 'https://github.com/biocross/unlimit'
+    spec.metadata['changelog_uri'] = 'https://github.com/biocross/unlimit'
   else
-    raise "RubyGems 2.0 or newer is required to protect against " \
-      "public gem pushes."
+    raise 'RubyGems 2.0 or newer is required to protect against ' \
+      'public gem pushes.'
   end
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
-  spec.executables   = ["unlimit"]
-  spec.require_paths = ["lib"]
+  spec.executables   = ['unlimit']
+  spec.require_paths = ['lib']
 
-  spec.add_dependency "xcodeproj"
-  spec.add_dependency "plist"
-  spec.add_dependency "fastlane"
-  spec.add_dependency "configure_extensions"
-  
-  spec.add_development_dependency "bundler", "~> 1.17"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_dependency 'xcodeproj'
+  spec.add_dependency 'plist'
+  spec.add_dependency 'fastlane', '>= 2.116.0'
+  spec.add_dependency 'configure_extensions'
+  spec.add_dependency 'highline'
+
+  spec.add_development_dependency 'bundler', '~> 1.17'
+  spec.add_development_dependency 'rake', '~> 10.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unlimit
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Siddharth Gupta
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-26 00:00:00.000000000 Z
+date: 2019-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: xcodeproj
@@ -40,6 +40,20 @@ dependencies:
         version: '0'
 - !ruby/object:Gem::Dependency
   name: fastlane
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.116.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.116.0
+- !ruby/object:Gem::Dependency
+  name: configure_extensions
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -53,7 +67,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: configure_extensions
+  name: highline
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -104,6 +118,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- CHANGELOG.md
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt