Class: FastlaneCore::Project
- Inherits:
-
Object
- Object
- FastlaneCore::Project
- Defined in:
- lib/fastlane_core/project.rb
Overview
Represents an Xcode project
Instance Attribute Summary collapse
-
#is_workspace ⇒ Object
Is this project a workspace?.
-
#options ⇒ Object
The config object containing the scheme, configuration, etc.
-
#path ⇒ Object
Path to the project/workspace.
Raw Access collapse
-
#build_settings(key: nil, optional: true, silent: false) ⇒ Object
Get the build settings for our project this is used to properly get the DerivedData folder.
- #raw_info(silent: false) ⇒ Object
Class Method Summary collapse
-
.detect_projects(config) ⇒ Object
Project discovery.
- .select_project(config) ⇒ Object
Instance Method Summary collapse
- #app_name ⇒ Object
-
#configurations ⇒ Object
Get all available configurations in an array.
-
#initialize(options) ⇒ Project
constructor
A new instance of Project.
- #ios? ⇒ Boolean
- #mac? ⇒ Boolean
-
#schemes ⇒ Object
Get all available schemes in an array.
-
#select_scheme ⇒ Object
Let the user select a scheme.
- #workspace? ⇒ Boolean
- #xcodebuild_parameters ⇒ Object
Constructor Details
#initialize(options) ⇒ Project
Returns a new instance of Project.
69 70 71 72 73 74 75 76 77 |
# File 'lib/fastlane_core/project.rb', line 69 def initialize() self. = self.path = File.([:workspace] || [:project]) self.is_workspace = ([:workspace].to_s.length > 0) if !path or !File.directory?(path) raise "Could not find project at path '#{path}'".red end end |
Instance Attribute Details
#is_workspace ⇒ Object
Is this project a workspace?
64 65 66 |
# File 'lib/fastlane_core/project.rb', line 64 def is_workspace @is_workspace end |
#options ⇒ Object
The config object containing the scheme, configuration, etc.
67 68 69 |
# File 'lib/fastlane_core/project.rb', line 67 def @options end |
#path ⇒ Object
Path to the project/workspace
61 62 63 |
# File 'lib/fastlane_core/project.rb', line 61 def path @path end |
Class Method Details
.detect_projects(config) ⇒ Object
Project discovery
6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 |
# File 'lib/fastlane_core/project.rb', line 6 def detect_projects(config) if config[:workspace].to_s.length > 0 and config[:project].to_s.length > 0 raise "You can only pass either a workspace or a project path, not both".red end return if config[:project].to_s.length > 0 if config[:workspace].to_s.length == 0 workspace = Dir["./*.xcworkspace"] if workspace.count > 1 puts "Select Workspace: " config[:workspace] = choose(*(workspace)) else config[:workspace] = workspace.first # this will result in nil if no files were found end end return if config[:workspace].to_s.length > 0 if config[:workspace].to_s.length == 0 and config[:project].to_s.length == 0 project = Dir["./*.xcodeproj"] if project.count > 1 puts "Select Project: " config[:project] = choose(*(project)) else config[:project] = project.first # this will result in nil if no files were found end end if config[:workspace].nil? and config[:project].nil? select_project(config) end end |
.select_project(config) ⇒ Object
40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 |
# File 'lib/fastlane_core/project.rb', line 40 def select_project(config) loop do path = ask("Couldn't automatically detect the project file, please provide a path: ".yellow).strip if File.directory? path if path.end_with? ".xcworkspace" config[:workspace] = path break elsif path.end_with? ".xcodeproj" config[:project] = path break else Helper.log.error "Path must end with either .xcworkspace or .xcodeproj" end else Helper.log.error "Couldn't find project at path '#{File.(path)}'".red end end end |
Instance Method Details
#app_name ⇒ Object
154 155 156 157 158 159 160 161 |
# File 'lib/fastlane_core/project.rb', line 154 def app_name # WRAPPER_NAME: Example.app # WRAPPER_SUFFIX: .app name = build_settings(key: "WRAPPER_NAME") return name.gsub(build_settings(key: "WRAPPER_SUFFIX"), "") if name return "App" # default value end |
#build_settings(key: nil, optional: true, silent: false) ⇒ Object
Get the build settings for our project this is used to properly get the DerivedData folder
190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 |
# File 'lib/fastlane_core/project.rb', line 190 def build_settings(key: nil, optional: true, silent: false) unless @build_settings # We also need to pass the workspace and scheme to this command command = "xcrun xcodebuild -showBuildSettings #{xcodebuild_parameters.join(' ')}" Helper.log.info command.yellow unless silent @build_settings = `#{command}` end begin result = @build_settings.split("\n").find { |c| c.include? key } return result.split(" = ").last rescue => ex return nil if optional # an optional value, we really don't care if something goes wrong Helper.log.error caller.join("\n\t") Helper.log.error "Could not fetch #{key} from project file: #{ex}" end nil end |
#configurations ⇒ Object
Get all available configurations in an array
134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 |
# File 'lib/fastlane_core/project.rb', line 134 def configurations results = [] splitted = raw_info.split("Configurations:") return [] if splitted.count != 2 # probably a CocoaPods project output = splitted.last.split(":").first output.split("\n").each_with_index do |current, index| current = current.strip if current.length == 0 next if index == 0 break # as we want to break on the empty line end results << current end results end |
#ios? ⇒ Boolean
170 171 172 |
# File 'lib/fastlane_core/project.rb', line 170 def ios? !mac? end |
#mac? ⇒ Boolean
163 164 165 166 167 168 |
# File 'lib/fastlane_core/project.rb', line 163 def mac? # Some projects have different values... we have to look for all of them return true if build_settings(key: "PLATFORM_NAME") == "macosx" return true if build_settings(key: "PLATFORM_DISPLAY_NAME") == "OS X" false end |
#raw_info(silent: false) ⇒ Object
211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 |
# File 'lib/fastlane_core/project.rb', line 211 def raw_info(silent: false) # Examples: # Standard: # # Information about project "Example": # Targets: # Example # ExampleUITests # # Build Configurations: # Debug # Release # # If no build configuration is specified and -scheme is not passed then "Release" is used. # # Schemes: # Example # ExampleUITests # CococaPods # # Example.xcworkspace # Information about workspace "Example": # Schemes: # Example # HexColors # Pods-Example return @raw if @raw # Unfortunately since we pass the workspace we also get all the # schemes generated by CocoaPods = xcodebuild_parameters.delete_if { |a| a.to_s.include? "scheme" } command = "xcrun xcodebuild -list #{.join(' ')}" Helper.log.info command.yellow unless silent @raw = `#{command}`.to_s raise "Error parsing xcode file using `#{command}`".red if @raw.length == 0 return @raw end |
#schemes ⇒ Object
Get all available schemes in an array
84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 |
# File 'lib/fastlane_core/project.rb', line 84 def schemes results = [] output = raw_info.split("Schemes:").last.split(":").first if raw_info.include?("There are no schemes in workspace") or raw_info.include?("This project contains no schemes") return results end output.split("\n").each do |current| current = current.strip next if current.length == 0 results << current end results end |
#select_scheme ⇒ Object
Let the user select a scheme
103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 |
# File 'lib/fastlane_core/project.rb', line 103 def select_scheme if [:scheme].to_s.length > 0 # Verify the scheme is available unless schemes.include?([:scheme].to_s) Helper.log.error "Couldn't find specified scheme '#{[:scheme]}'.".red [:scheme] = nil end end return if [:scheme].to_s.length > 0 if schemes.count == 1 [:scheme] = schemes.last elsif schemes.count > 1 if Helper.is_ci? Helper.log.error "Multiple schemes found but you haven't specified one.".red Helper.log.error "Since this is a CI, please pass one using the `scheme` option".red raise "Multiple schemes found".red else puts "Select Scheme: " [:scheme] = choose(*(schemes)) end else Helper.log.error "Couldn't find any schemes in this project, make sure that the scheme is shared if you are using a workspace".red Helper.log.error "Open Xcode, click on `Manage Schemes` and check the `Shared` box for the schemes you want to use".red raise "No Schemes found".red end end |
#workspace? ⇒ Boolean
79 80 81 |
# File 'lib/fastlane_core/project.rb', line 79 def workspace? self.is_workspace end |
#xcodebuild_parameters ⇒ Object
174 175 176 177 178 179 180 181 |
# File 'lib/fastlane_core/project.rb', line 174 def xcodebuild_parameters proj = [] proj << "-workspace '#{[:workspace]}'" if [:workspace] proj << "-scheme '#{[:scheme]}'" if [:scheme] proj << "-project '#{[:project]}'" if [:project] return proj end |