class Pod::Validator
Validates a Specification
.
Extends the Linter from the Core to add additional which require the LocalPod and the Installer
.
In detail it checks that the file patterns defined by the user match actually do match at least a file and that the Pod
builds, by installing it without integration and building the project with xcodebuild.
Constants
- DEFAULT_SWIFT_VERSION
The default version of Swift to use when linting pods
- FILE_PATTERNS
- VALID_PLATFORMS
The valid platforms for linting
Attributes
@return [Bool] Whether the validator should fail on warnings, or only on errors.
@return [Bool] whether the linter should fail as soon as the first build
variant causes an error. Helpful for i.e. multi-platforms specs, specs with subspecs.
@return [Sandbox::FileAccessor] the file accessor for the spec.
@return [Boolean] Whether attributes that affect only public sources
Bool be skipped.
@return [Specification::Linter] the linter instance from CocoaPods
Core.
@return [Bool] whether the validation should be performed against the root of
the podspec instead to its original source.
@note Uses the `:path` option of the Podfile.
@return [Bool] whether the validation should be performed against the root of
the podspec instead to its original source.
@note Uses the `:path` option of the Podfile.
@return [Bool] whether the linter should not clean up temporary files
for inspection.
@return [Bool] Whether the validator should validate all subspecs.
@return [String] name of the subspec to check, if nil all subspecs are checked.
@return [Bool] whether the validation should skip the checks that
requires the download of the library.
@return [Bool] Whether the validator should skip building and running tests.
@return [Array<String>] an array of source URLs used to create the
{Podfile} used in the linting process
Set the SWIFT_VERSION that should be used to validate the pod.
@return [Bool] Whether frameworks should be used for the installation.
Public Class Methods
Initialize a new instance
@param [Specification, Pathname, String] spec_or_path
the Specification or the path of the `podspec` file to lint.
@param [Array<String>] source_urls
the Source URLs to use in creating a {Podfile}.
@param. [Array<String>] platforms
the platforms to lint.
# File lib/cocoapods/validator.rb, line 41 def initialize(spec_or_path, source_urls, platforms = []) @linter = Specification::Linter.new(spec_or_path) @source_urls = if @linter.spec && @linter.spec.dependencies.empty? && @linter.spec.recursive_subspecs.all? { |s| s.dependencies.empty? } [] else source_urls.map { |url| config.sources_manager.source_with_name_or_url(url) }.map(&:url) end @platforms = platforms.map do |platform| result = case platform.to_s.downcase # Platform doesn't recognize 'macos' as being the same as 'osx' when initializing when 'macos' then Platform.macos else Platform.new(platform, nil) end unless valid_platform?(result) raise Informative, "Unrecognized platform `#{platform}`. Valid platforms: #{VALID_PLATFORMS.join(', ')}" end result end end
Public Instance Methods
@return [String] the SWIFT_VERSION in the .swift-version file or nil.
# File lib/cocoapods/validator.rb, line 314 def dot_swift_version return unless file swift_version_path = file.dirname + '.swift-version' return unless swift_version_path.exist? swift_version_path.read.strip end
# File lib/cocoapods/validator.rb, line 176 def failure_reason results_by_type = results.group_by(&:type) results_by_type.default = [] return nil if validated? reasons = [] if (size = results_by_type[:error].size) && size > 0 reasons << "#{size} #{'error'.pluralize(size)}" end if !allow_warnings && (size = results_by_type[:warning].size) && size > 0 reason = "#{size} #{'warning'.pluralize(size)}" pronoun = size == 1 ? 'it' : 'them' reason << " (but you can use `--allow-warnings` to ignore #{pronoun})" if reasons.empty? reasons << reason end if results.all?(&:public_only) reasons << 'all results apply only to public specs, but you can use ' \ '`--private` to ignore them if linting the specification for a private pod' end reasons.to_sentence end
@return [Pathname] the path of the `podspec` file where {#spec} is
defined.
# File lib/cocoapods/validator.rb, line 73 def file @linter.file end
Returns a list of platforms to lint for a given Specification
@param [Specification] spec
The specification to lint
@return [Array<Platform>] platforms to lint for the given specification
# File lib/cocoapods/validator.rb, line 84 def platforms_to_lint(spec) return spec.available_platforms if @platforms.empty? # Validate that the platforms specified are actually supported by the spec results = @platforms.map do |platform| matching_platform = spec.available_platforms.find { |p| p.name == platform.name } unless matching_platform raise Informative, "Platform `#{platform}` is not supported by specification `#{spec}`." end matching_platform end.uniq results end
Prints the result of the validation to the user.
@return [void]
# File lib/cocoapods/validator.rb, line 139 def print_results UI.puts results_message end
@return [Symbol] The color, which should been used to display the result.
One of: `:green`, `:yellow`, `:red`.
# File lib/cocoapods/validator.rb, line 284 def result_color case result_type when :error then :red when :warning then :yellow else :green end end
@return [Symbol] The type, which should been used to display the result.
One of: `:error`, `:warning`, `:note`.
# File lib/cocoapods/validator.rb, line 271 def result_type applicable_results = results applicable_results = applicable_results.reject(&:public_only?) if ignore_public_only_results types = applicable_results.map(&:type).uniq if types.include?(:error) then :error elsif types.include?(:warning) then :warning else :note end end
# File lib/cocoapods/validator.rb, line 143 def results_message message = '' results.each do |result| if result.platforms == [:ios] platform_message = '[iOS] ' elsif result.platforms == [:osx] platform_message = '[OSX] ' elsif result.platforms == [:watchos] platform_message = '[watchOS] ' elsif result.platforms == [:tvos] platform_message = '[tvOS] ' end subspecs_message = '' if result.is_a?(Result) subspecs = result.subspecs.uniq if subspecs.count > 2 subspecs_message = '[' + subspecs[0..2].join(', ') + ', and more...] ' elsif subspecs.count > 0 subspecs_message = '[' + subspecs.join(',') + '] ' end end case result.type when :error then type = 'ERROR' when :warning then type = 'WARN' when :note then type = 'NOTE' else raise "#{result.type}" end message << " - #{type.ljust(5)} | #{platform_message}#{subspecs_message}#{result.attribute_name}: #{result.message}\n" end message << "\n" end
@return [Specification] the specification to lint.
# File lib/cocoapods/validator.rb, line 66 def spec @linter.spec end
@return [String] the SWIFT_VERSION to use for validation.
# File lib/cocoapods/validator.rb, line 299 def swift_version return @swift_version unless @swift_version.nil? if (version = spec.swift_version) || (version = dot_swift_version) @swift_version = version.to_s else DEFAULT_SWIFT_VERSION end end
@return [Boolean] Whether any of the pod targets part of this validator use Swift or not.
# File lib/cocoapods/validator.rb, line 323 def uses_swift? @installer.pod_targets.any?(&:uses_swift?) end
Lints the specification adding a {Result} for any failed check to the {#results} list.
@note This method shows immediately which pod is being processed and
overrides the printed line once the result is known.
@return [Bool] whether the specification passed validation.
# File lib/cocoapods/validator.rb, line 113 def validate @results = [] # Replace default spec with a subspec if asked for a_spec = spec if spec && @only_subspec subspec_name = @only_subspec.start_with?(spec.root.name) ? @only_subspec : "#{spec.root.name}/#{@only_subspec}" a_spec = spec.subspec_by_name(subspec_name, true, true) @subspec_name = a_spec.name end UI.print " -> #{a_spec ? a_spec.name : file.basename}\r" unless config.silent? $stdout.flush perform_linting perform_extensive_analysis(a_spec) if a_spec && !quick UI.puts ' -> '.send(result_color) << (a_spec ? a_spec.to_s : file.basename.to_s) print_results validated? end
@return [Boolean]
# File lib/cocoapods/validator.rb, line 264 def validated? result_type != :error && (result_type != :warning || allow_warnings) end
@return [Pathname] the temporary directory used by the linter.
# File lib/cocoapods/validator.rb, line 293 def validation_dir @validation_dir ||= Pathname(Dir.mktmpdir(['CocoaPods-Lint-', "-#{spec.name}"])) end
Private Instance Methods
Ensures that a list of header files only contains header files.
# File lib/cocoapods/validator.rb, line 722 def _validate_header_files(attr_name) header_files = file_accessor.send(attr_name) non_header_files = header_files. select { |f| !Sandbox::FileAccessor::HEADER_EXTENSIONS.include?(f.extname) }. map { |f| f.relative_path_from(file_accessor.root) } unless non_header_files.empty? error(attr_name, "The pattern matches non-header files (#{non_header_files.join(', ')}).") end non_source_files = header_files - file_accessor.source_files unless non_source_files.empty? error(attr_name, 'The pattern includes header files that are not listed ' \ "in source_files (#{non_source_files.join(', ')}).") end end
# File lib/cocoapods/validator.rb, line 737 def _validate_header_mappings_dir return unless header_mappings_dir = file_accessor.spec_consumer.header_mappings_dir absolute_mappings_dir = file_accessor.root + header_mappings_dir unless absolute_mappings_dir.directory? error('header_mappings_dir', "The header_mappings_dir (`#{header_mappings_dir}`) is not a directory.") end non_mapped_headers = file_accessor.headers. reject { |h| h.to_path.start_with?(absolute_mappings_dir.to_path) }. map { |f| f.relative_path_from(file_accessor.root) } unless non_mapped_headers.empty? error('header_mappings_dir', "There are header files outside of the header_mappings_dir (#{non_mapped_headers.join(', ')}).") end end
# File lib/cocoapods/validator.rb, line 695 def _validate_license unless file_accessor.license || spec.license && (spec.license[:type] == 'Public Domain' || spec.license[:text]) warning('license', 'Unable to find a license file') end end
# File lib/cocoapods/validator.rb, line 701 def _validate_module_map if spec.module_map unless file_accessor.module_map.exist? error('module_map', 'Unable to find the specified module map file.') end unless file_accessor.module_map.extname == '.modulemap' relative_path = file_accessor.module_map.relative_path_from file_accessor.root error('module_map', "Unexpected file extension for modulemap file (#{relative_path}).") end end end
# File lib/cocoapods/validator.rb, line 685 def _validate_private_header_files _validate_header_files(:private_header_files) validate_nonempty_patterns(:private_header_files, :warning) end
# File lib/cocoapods/validator.rb, line 690 def _validate_public_header_files _validate_header_files(:public_header_files) validate_nonempty_patterns(:public_header_files, :warning) end
# File lib/cocoapods/validator.rb, line 713 def _validate_resource_bundles file_accessor.resource_bundles.each do |bundle, resource_paths| next unless resource_paths.empty? error('file patterns', "The `resource_bundles` pattern for `#{bundle}` did not match any file.") end end
Executes the given command in the current working directory.
@return [String] The output of the given command
# File lib/cocoapods/validator.rb, line 936 def _xcodebuild(command, raise_on_failure = false) Executable.execute_command('xcodebuild', command, raise_on_failure) end
# File lib/cocoapods/validator.rb, line 527 def add_app_project_import app_project = Xcodeproj::Project.open(validation_dir + 'App.xcodeproj') app_target = app_project.targets.first pod_target = @installer.pod_targets.find { |pt| pt.pod_name == spec.root.name } Pod::Generator::AppTargetHelper.add_app_project_import(app_project, app_target, pod_target, consumer.platform_name) Pod::Generator::AppTargetHelper.add_xctest_search_paths(app_target) if @installer.pod_targets.any? { |pt| pt.spec_consumers.any? { |c| c.frameworks.include?('XCTest') } } Pod::Generator::AppTargetHelper.add_empty_swift_file(app_project, app_target) if @installer.pod_targets.any?(&:uses_swift?) app_project.save Xcodeproj::XCScheme.share_scheme(app_project.path, 'App') # Share the pods xcscheme only if it exists. For pre-built vendored pods there is no xcscheme generated. Xcodeproj::XCScheme.share_scheme(@installer.pods_project.path, pod_target.label) if shares_pod_target_xcscheme?(pod_target) end
# File lib/cocoapods/validator.rb, line 796 def add_result(type, attribute_name, message, public_only = false) result = results.find do |r| r.type == type && r.attribute_name && r.message == message && r.public_only? == public_only end unless result result = Result.new(type, attribute_name, message, public_only) results << result end result.platforms << consumer.platform_name if consumer result.subspecs << subspec_name if subspec_name && !result.subspecs.include?(subspec_name) end
Performs platform specific analysis. It requires to download the source at each iteration
@note Xcode warnings are treated as notes because the spec maintainer
might not be the author of the library
@return [void]
# File lib/cocoapods/validator.rb, line 598 def build_pod if !xcodebuild_available? UI.warn "Skipping compilation with `xcodebuild` because it can't be found.\n".yellow else UI.message "\nBuilding with `xcodebuild`.\n".yellow do scheme = if skip_import_validation? pod_target = @installer.pod_targets.find { |pt| pt.pod_name == spec.root.name } pod_target.label if pod_target.should_build? else 'App' end if scheme.nil? UI.warn "Skipping compilation with `xcodebuild` because target contains no sources.\n".yellow else output = xcodebuild('build', scheme, 'Release') parsed_output = parse_xcodebuild_output(output) translate_output_to_linter_messages(parsed_output) end end end end
It checks that every file pattern specified in a spec yields at least one file. It requires the pods to be already present in the current working directory under Pods/spec.name.
@return [void]
# File lib/cocoapods/validator.rb, line 657 def check_file_patterns FILE_PATTERNS.each do |attr_name| if respond_to?("_validate_#{attr_name}", true) send("_validate_#{attr_name}") else validate_nonempty_patterns(attr_name, :error) end end _validate_header_mappings_dir if consumer.spec.root? _validate_license _validate_module_map end end
# File lib/cocoapods/validator.rb, line 552 def configure_pod_targets(targets, target_installation_results, deployment_target) target_installation_results.first.values.each do |pod_target_installation_result| pod_target = pod_target_installation_result.target native_target = pod_target_installation_result.native_target native_target.build_configuration_list.build_configurations.each do |build_configuration| (build_configuration.build_settings['OTHER_CFLAGS'] ||= '$(inherited)') << ' -Wincomplete-umbrella' build_configuration.build_settings['SWIFT_VERSION'] = (pod_target.swift_version || swift_version) if pod_target.uses_swift? end pod_target_installation_result.test_specs_by_native_target.each do |test_native_target, test_specs| if pod_target.uses_swift_for_test_type?(test_specs.first.test_type) test_native_target.build_configuration_list.build_configurations.each do |build_configuration| build_configuration.build_settings['SWIFT_VERSION'] = swift_version end end end end targets.each do |target| if target.pod_targets.any?(&:uses_swift?) && consumer.platform_name == :ios && (deployment_target.nil? || Version.new(deployment_target).major < 8) uses_xctest = target.spec_consumers.any? { |c| (c.frameworks + c.weak_frameworks).include? 'XCTest' } error('swift', 'Swift support uses dynamic frameworks and is therefore only supported on iOS > 8.') unless uses_xctest end end end
# File lib/cocoapods/validator.rb, line 519 def create_app_project app_project = Xcodeproj::Project.new(validation_dir + 'App.xcodeproj') app_target = Pod::Generator::AppTargetHelper.add_app_target(app_project, consumer.platform_name, deployment_target) Pod::Generator::AppTargetHelper.add_swift_version(app_target, swift_version) app_project.save app_project.recreate_user_schemes end
# File lib/cocoapods/validator.rb, line 500 def deployment_target deployment_target = spec.subspec_by_name(subspec_name).deployment_target(consumer.platform_name) if consumer.platform_name == :ios && use_frameworks minimum = Version.new('8.0') deployment_target = [Version.new(deployment_target), minimum].max.to_s end deployment_target end
# File lib/cocoapods/validator.rb, line 509 def download_pod podfile = podfile_from_spec(consumer.platform_name, deployment_target, use_frameworks, consumer.spec.test_specs.map(&:name)) sandbox = Sandbox.new(config.sandbox_root) @installer = Installer.new(sandbox, podfile) @installer.use_default_plugins = false @installer.has_dependencies = !spec.dependencies.empty? %i(prepare resolve_dependencies download_dependencies).each { |m| @installer.send(m) } @file_accessor = @installer.pod_targets.flat_map(&:file_accessors).find { |fa| fa.spec.name == consumer.spec.name } end
!@group Result
Helpers
# File lib/cocoapods/validator.rb, line 757 def error(*args) add_result(:error, *args) end
It creates a podfile in memory and builds a library containing the pod for all available platforms with xcodebuild.
# File lib/cocoapods/validator.rb, line 543 def install_pod %i(validate_targets generate_pods_project integrate_user_project perform_post_install_actions).each { |m| @installer.send(m) } deployment_target = spec.subspec_by_name(subspec_name).deployment_target(consumer.platform_name) configure_pod_targets(@installer.aggregate_targets, @installer.target_installation_results, deployment_target) @installer.pods_project.save end
# File lib/cocoapods/validator.rb, line 765 def note(*args) add_result(:note, *args) end
Parse the xcode build output to identify the lines which are relevant to the linter.
@param [String] output the output generated by the xcodebuild tool.
@note The indentation and the temporary path is stripped form the
lines.
@return [Array<String>] the lines that are relevant to the linter.
# File lib/cocoapods/validator.rb, line 889 def parse_xcodebuild_output(output) lines = output.split("\n") selected_lines = lines.select do |l| l.include?('error: ') && (l !~ /errors? generated\./) && (l !~ /error: \(null\)/) || l.include?('warning: ') && (l !~ /warnings? generated\./) && (l !~ /frameworks only run on iOS 8/) || l.include?('note: ') && (l !~ /expanded from macro/) end selected_lines.map do |l| new = l.gsub(%r{#{validation_dir}/Pods/}, '') new.gsub!(/^ */, ' ') end end
Perform analysis for a given spec (or subspec)
# File lib/cocoapods/validator.rb, line 342 def perform_extensive_analysis(spec) if spec.test_specification? error('spec', "Validating a test spec (`#{spec.name}`) is not supported.") return false end validate_homepage(spec) validate_screenshots(spec) validate_social_media_url(spec) validate_documentation_url(spec) validate_source_url(spec) platforms = platforms_to_lint(spec) valid = platforms.send(fail_fast ? :all? : :each) do |platform| UI.message "\n\n#{spec} - Analyzing on #{platform} platform.".green.reversed @consumer = spec.consumer(platform) setup_validation_environment begin create_app_project download_pod check_file_patterns install_pod validate_swift_version add_app_project_import validate_vendored_dynamic_frameworks build_pod test_pod unless skip_tests ensure tear_down_validation_environment end validated? end return false if fail_fast && !valid perform_extensive_subspec_analysis(spec) unless @no_subspecs rescue => e message = e.to_s message << "\n" << e.backtrace.join("\n") << "\n" if config.verbose? error('unknown', "Encountered an unknown error (#{message}) during validation.") false end
Recursively perform the extensive analysis on all subspecs
# File lib/cocoapods/validator.rb, line 385 def perform_extensive_subspec_analysis(spec) spec.subspecs.reject(&:test_specification?).send(fail_fast ? :all? : :each) do |subspec| @subspec_name = subspec.name perform_extensive_analysis(subspec) end end
# File lib/cocoapods/validator.rb, line 335 def perform_linting linter.lint @results.concat(linter.results.to_a) end
Whether the provided name matches the platform
@param [Platform] platform
The platform
@param [String] name
The name to check against the provided platform
# File lib/cocoapods/validator.rb, line 975 def platform_name_match?(platform, name) [platform.name, platform.string_name].any? { |n| n.casecmp(name) == 0 } end
@param [String] platform_name
the name of the platform, which should be declared in the Podfile.
@param [String] deployment_target
the deployment target, which should be declared in the Podfile.
@param [Bool] use_frameworks
whether frameworks should be used for the installation
@param [Array<String>] test_spec_names
the test spec names to include in the podfile.
@return [Podfile] a podfile that requires the specification on the
current platform.
@note The generated podfile takes into account whether the linter is
in local mode.
# File lib/cocoapods/validator.rb, line 850 def podfile_from_spec(platform_name, deployment_target, use_frameworks = true, test_spec_names = []) name = subspec_name || spec.name podspec = file.realpath local = local? urls = source_urls Pod::Podfile.new do install! 'cocoapods', :deterministic_uuids => false # By default inhibit warnings for all pods, except the one being validated. inhibit_all_warnings! urls.each { |u| source(u) } target 'App' do use_frameworks!(use_frameworks) platform(platform_name, deployment_target) if local pod name, :path => podspec.dirname.to_s, :inhibit_warnings => false else pod name, :podspec => podspec.to_s, :inhibit_warnings => false end test_spec_names.each do |test_spec_name| if local pod test_spec_name, :path => podspec.dirname.to_s, :inhibit_warnings => false else pod test_spec_name, :podspec => podspec.to_s, :inhibit_warnings => false end end end end end
# File lib/cocoapods/validator.rb, line 487 def setup_validation_environment validation_dir.rmtree if validation_dir.exist? validation_dir.mkpath @original_config = Config.instance.clone config.installation_root = validation_dir config.silent = !config.verbose end
Whether the platform is supported by the specification
@param [Platform] platform
The platform to check
@param [Specification] specification
The specification which must support the provided platform
@return [Bool] Whether the platform is supported by the specification
# File lib/cocoapods/validator.rb, line 961 def supported_platform?(platform, spec) available_platforms = spec.available_platforms available_platforms.any? { |p| p.name == platform.name } end
# File lib/cocoapods/validator.rb, line 495 def tear_down_validation_environment validation_dir.rmtree unless no_clean Config.instance = @original_config end
Builds and runs all test sources associated with the current specification being validated.
@note Xcode warnings are treated as notes because the spec maintainer
might not be the author of the library
@return [void]
# File lib/cocoapods/validator.rb, line 627 def test_pod if !xcodebuild_available? UI.warn "Skipping test validation with `xcodebuild` because it can't be found.\n".yellow else UI.message "\nTesting with `xcodebuild`.\n".yellow do pod_target = @installer.pod_targets.find { |pt| pt.pod_name == spec.root.name } consumer.spec.test_specs.each do |test_spec| scheme = @installer.target_installation_results.first[pod_target.name].native_target_for_spec(test_spec) output = xcodebuild('test', scheme, 'Debug') parsed_output = parse_xcodebuild_output(output) translate_output_to_linter_messages(parsed_output) end end end end
# File lib/cocoapods/validator.rb, line 769 def translate_output_to_linter_messages(parsed_output) parsed_output.each do |message| # Checking the error for `InputFile` is to work around an Xcode # issue where linting would fail even though `xcodebuild` actually # succeeds. Xcode.app also doesn't fail when this issue occurs, so # it's safe for us to do the same. # # For more details see https://github.com/CocoaPods/CocoaPods/issues/2394#issuecomment-56658587 # if message.include?("'InputFile' should have") next end if message =~ /\S+:\d+:\d+: error:/ error('xcodebuild', message) elsif message =~ /\S+:\d+:\d+: warning:/ warning('xcodebuild', message) else note('xcodebuild', message) end end end
Whether the platform with the specified name is valid
@param [Platform] platform
The platform to check
@return [Bool] True if the platform is valid
# File lib/cocoapods/validator.rb, line 947 def valid_platform?(platform) VALID_PLATFORMS.any? { |p| p.name == platform.name } end
Performs validations related to the `documentation_url` attribute.
# File lib/cocoapods/validator.rb, line 436 def validate_documentation_url(spec) validate_url(spec.documentation_url) if spec.documentation_url end
Performs validations related to the `homepage` attribute.
# File lib/cocoapods/validator.rb, line 411 def validate_homepage(spec) if spec.homepage validate_url(spec.homepage) end end
Validates that the file patterns in `attr_name` match at least 1 file.
@param [String,Symbol] attr_name the name of the attribute to check (ex. :public_header_files)
@param [String,Symbol] message_type the type of message to send if the patterns are empty (ex. :error)
# File lib/cocoapods/validator.rb, line 679 def validate_nonempty_patterns(attr_name, message_type) return unless !file_accessor.spec_consumer.send(attr_name).empty? && file_accessor.send(attr_name).empty? add_result(message_type, 'file patterns', "The `#{attr_name}` pattern did not match any file.") end
Performs validation related to the `screenshots` attribute.
# File lib/cocoapods/validator.rb, line 419 def validate_screenshots(spec) spec.screenshots.compact.each do |screenshot| response = validate_url(screenshot) if response && !(response.headers['content-type'] && response.headers['content-type'].first =~ /image\/.*/i) warning('screenshot', "The screenshot #{screenshot} is not a valid image.") end end end
Performs validations related to the `source` -> `http` attribute (if exists)
# File lib/cocoapods/validator.rb, line 442 def validate_source_url(spec) return if spec.source.nil? || spec.source[:http].nil? url = URI(spec.source[:http]) return if url.scheme == 'https' || url.scheme == 'file' warning('http', "The URL (`#{url}`) doesn't use the encrypted HTTPs protocol. " \ 'It is crucial for Pods to be transferred over a secure protocol to protect your users from man-in-the-middle attacks. '\ 'This will be an error in future releases. Please update the URL to use https.') end
Performs validation for which version of Swift is used during validation.
An error will be displayed if the user has provided a `swift_version` attribute within the podspec but is also using either `–swift-version` parameter or a `.swift-version with a different Swift version.
The user will be warned that the default version of Swift was used if the following things are true:
- The project uses Swift at all - The user did not supply a Swift version via a parameter - There is no `swift_version` attribute set within the specification - There is no `.swift-version` file present either.
# File lib/cocoapods/validator.rb, line 462 def validate_swift_version return unless uses_swift? spec_swift_version = spec.swift_version unless spec_swift_version.nil? message = nil if !dot_swift_version.nil? && dot_swift_version != spec_swift_version.to_s message = "Specification `#{spec.name}` specifies an inconsistent `swift_version` (`#{spec_swift_version}`) compared to the one present in your `.swift-version` file (`#{dot_swift_version}`). " \ 'Please remove the `.swift-version` file which is now deprecated and only use the `swift_version` attribute within your podspec.' elsif !@swift_version.nil? && @swift_version != spec_swift_version.to_s message = "Specification `#{spec.name}` specifies an inconsistent `swift_version` (`#{spec_swift_version}`) compared to the one passed during lint (`#{@swift_version}`)." end unless message.nil? error('swift', message) return end end if @swift_version.nil? && spec_swift_version.nil? && dot_swift_version.nil? warning('swift', 'The validator used ' \ "Swift #{DEFAULT_SWIFT_VERSION} by default because no Swift version was specified. " \ 'To specify a Swift version during validation, add the `swift_version` attribute in your podspec. ' \ 'Note that usage of the `--swift-version` parameter or a `.swift-version` file is now deprecated.') end end
Performs validation of a URL
# File lib/cocoapods/validator.rb, line 397 def validate_url(url) resp = Pod::HTTP.validate_url(url) if !resp warning('url', "There was a problem validating the URL #{url}.", true) elsif !resp.success? warning('url', "The URL (#{url}) is not reachable.", true) end resp end
# File lib/cocoapods/validator.rb, line 577 def validate_vendored_dynamic_frameworks deployment_target = spec.subspec_by_name(subspec_name).deployment_target(consumer.platform_name) unless file_accessor.nil? dynamic_frameworks = file_accessor.vendored_dynamic_frameworks dynamic_libraries = file_accessor.vendored_dynamic_libraries if (dynamic_frameworks.count > 0 || dynamic_libraries.count > 0) && consumer.platform_name == :ios && (deployment_target.nil? || Version.new(deployment_target).major < 8) error('dynamic', 'Dynamic frameworks and libraries are only supported on iOS 8.0 and onwards.') end end end
# File lib/cocoapods/validator.rb, line 761 def warning(*args) add_result(:warning, *args) end
@return [String] Executes xcodebuild in the current working directory and
returns its output (both STDOUT and STDERR).
# File lib/cocoapods/validator.rb, line 905 def xcodebuild(action, scheme, configuration) require 'fourflusher' command = %W(clean #{action} -workspace #{File.join(validation_dir, 'App.xcworkspace')} -scheme #{scheme} -configuration #{configuration}) case consumer.platform_name when :osx, :macos command += %w(CODE_SIGN_IDENTITY=) when :ios command += %w(CODE_SIGN_IDENTITY=- -sdk iphonesimulator) command += Fourflusher::SimControl.new.destination(:oldest, 'iOS', deployment_target) when :watchos command += %w(CODE_SIGN_IDENTITY=- -sdk watchsimulator) command += Fourflusher::SimControl.new.destination(:oldest, 'watchOS', deployment_target) when :tvos command += %w(CODE_SIGN_IDENTITY=- -sdk appletvsimulator) command += Fourflusher::SimControl.new.destination(:oldest, 'tvOS', deployment_target) end begin _xcodebuild(command, true) rescue => e message = 'Returned an unsuccessful exit code.' message += ' You can use `--verbose` for more information.' unless config.verbose? error('xcodebuild', message) e.message end end
# File lib/cocoapods/validator.rb, line 643 def xcodebuild_available? !Executable.which('xcodebuild').nil? && ENV['COCOAPODS_VALIDATOR_SKIP_XCODEBUILD'].nil? end