Модуль: Cask::Quarantine Приватный
- Расширен модулем:
- SystemCommand::Mixin, Utils::Output::Mixin
- Определён в:
- cask/quarantine.rb
Обзор
Этот модуль является частью приватного API. Этот модуль можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого модуля, так как он может быть удалён или изменён без предупреждения.
Вспомогательный модуль для помещения файлов в карантин.
Определено в пространстве имён
Классы: SigningIdentity
Краткое описание констант свернуть
- QUARANTINE_ATTRIBUTE =
Эта константа является частью приватного API. Эту константу можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этой константы, так как она может быть удалена или изменена без предупреждения.
"com.apple.quarantine"- USER_APPROVED_FLAG =
Эта константа является частью приватного API. Эту константу можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этой константы, так как она может быть удалена или изменена без предупреждения.
0x0040- QUARANTINE_SCRIPT =
Эта константа является частью приватного API. Эту константу можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этой константы, так как она может быть удалена или изменена без предупреждения.
T.let((HOMEBREW_LIBRARY_PATH/"cask/utils/quarantine.swift").freeze, Pathname)
- COPY_XATTRS_SCRIPT =
Эта константа является частью приватного API. Эту константу можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этой константы, так как она может быть удалена или изменена без предупреждения.
T.let((HOMEBREW_LIBRARY_PATH/"cask/utils/copy-xattrs.swift").freeze, Pathname)
Краткое описание методов класса свернуть
- .app_management_permissions_granted?(app:, command:) ⇒ Boolean приватный
Проверяет, есть ли у Homebrew разрешение на обновление приложений в macOS Ventura.
- .available? ⇒ Boolean приватный
- .cask!(cask: nil, download_path: nil, action: true) ⇒ void приватный
- .check_quarantine_support ⇒ Array<(Symbol, [String, nil])> приватный
- .copy_xattrs(from, to, command:) ⇒ void приватный
- .detect(file) ⇒ Boolean? приватный
- .propagate(from: nil, to: nil) ⇒ void приватный
- .release!(download_path: nil) ⇒ void приватный
- .signing_identity(file) ⇒ SigningIdentity? приватный
- .status(file) ⇒ String приватный
- .toggle_no_translocation_bit(attribute) ⇒ String приватный
- .user_approved?(file) ⇒ Boolean приватный
Методы, включённые из SystemCommand::Mixin
system_command, system_command!
Методы, включённые из Utils::Output::Mixin
issue_reporting_message, odebug, odeprecated, odie, odisabled, ofail, oh1, oh1_title, ohai, ohai_title, onoe, opoo, opoo_outside_github_actions, opoo_without_github_actions_annotation, pretty_deprecated, pretty_disabled, pretty_duration, pretty_install_status, pretty_installed, pretty_uninstalled, pretty_upgradable, pretty_warning
Подробное описание методов класса
.app_management_permissions_granted?(app:, command:) ⇒ Boolean
Этот метод является частью закрытого API. Этот метод можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого метода, поскольку он может быть удалён или изменён без предупреждения.
Проверяет, есть ли у Homebrew разрешение на обновление приложений в macOS Ventura. Это разрешение можно предоставить с помощью переключателя «Управление приложениями» или «Полный доступ к диску». Система покажет запрос только для управления приложениями, поэтому мы просим пользователя предоставить именно это разрешение.
293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 | # File 'cask/quarantine.rb', line 293 def self.(app:, command:) return true unless app.directory? # To get macOS to prompt the user for permissions, we need to actually attempt to # modify a file in the app. test_file = app/".homebrew-write-test" # We can't use app.writable? here because that conflates several access checks, # including both file ownership and whether system permissions are granted. # Here we just want to check whether sudo would be needed. looks_writable_without_sudo = if app.owned? app.lstat.mode.anybits?(0200) elsif app.grpowned? app.lstat.mode.anybits?(0020) else app.lstat.mode.anybits?(0002) end if looks_writable_without_sudo begin File.write(test_file, "") test_file.delete return true rescue Errno::EACCES, Errno::EPERM # Using error handler below end else begin command.run!( "touch", args: [ test_file, ], print_stderr: false, sudo: true, ) command.run!( "rm", args: [ test_file, ], print_stderr: false, sudo: true, ) return true rescue ErrorDuringExecution => e # We only want to handle "touch" errors here; propagate "sudo" errors up raise e unless e.stderr.include?("touch: #{test_file}: Operation not permitted") end end # Allow undocumented way to skip the prompt. if ENV["HOMEBREW_NO_APP_MANAGEMENT_PERMISSIONS_PROMPT"] opoo <<~EOF Your terminal does not have App Management permissions, so Homebrew will delete and reinstall the app. This may result in some configurations (like notification settings or location in the Dock/Launchpad) being lost. To fix this, go to System Settings → Privacy & Security → App Management and add or enable your terminal. EOF end false end |
.available? ⇒ Boolean
Этот метод является частью закрытого API. Этот метод можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого метода, поскольку он может быть удалён или изменён без предупреждения.
107 108 109 110 111 | # File 'cask/quarantine.rb', line 107 def self.available? @quarantine_support ||= T.let(check_quarantine_support, T.nilable([Symbol, T.nilable(String)])) @quarantine_support[0] == :quarantine_available end |
.cask!(cask: nil, download_path: nil, action: true) ⇒ void
Этот метод является частью закрытого API. Этот метод можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого метода, поскольку он может быть удалён или изменён без предупреждения.
Этот метод возвращает неопределённое значение.
201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 | # File 'cask/quarantine.rb', line 201 def self.cask!(cask: nil, download_path: nil, action: true) return if cask.nil? || download_path.nil? return if detect(download_path) odebug "Quarantining #{download_path}" raise "unexpected nil swift" unless swift quarantiner = system_command(T.must(swift), args: [ *swift_target_args, QUARANTINE_SCRIPT, download_path, cask.url.to_s, cask.homepage.to_s, ], print_stderr: false) return if quarantiner.success? case quarantiner.exit_status when 2 raise CaskQuarantineError.new(download_path, "Insufficient parameters") else raise CaskQuarantineError.new(download_path, quarantiner.stderr) end end |
.check_quarantine_support ⇒ Array<(Symbol, [String, nil])>
Этот метод является частью закрытого API. Этот метод можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого метода, поскольку он может быть удалён или изменён без предупреждения.
58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 | # File 'cask/quarantine.rb', line 58 def self.check_quarantine_support odebug "Checking quarantine support" check_output = nil status = if xattr.nil? || !system_command(T.must(xattr), args: ["-h"], print_stderr: false).success? odebug "There's no working version of `xattr` on this system." :xattr_broken elsif swift.nil? odebug "Swift is not available on this system." :no_swift else s = swift raise "unexpected nil swift" unless s api_check = system_command(s, args: [*swift_target_args, QUARANTINE_SCRIPT], print_stderr: false) exit_status = api_check.exit_status check_output = api_check.merged_output.to_s.strip error_output = api_check.stderr.to_s.strip case exit_status when 2 odebug "Quarantine is available." :quarantine_available when 1 # Swift script ran but failed (likely due to CLT issues) odebug "Swift quarantine script failed: #{error_output}" if error_output.include?("does not exist") || error_output.include?("No such file") :swift_broken_clt elsif error_output.include?("compiler") || error_output.include?("SDK") :swift_compilation_failed else :swift_runtime_error end when 127 # Command not found or execution failed odebug "Swift execution failed with exit status 127" :swift_not_executable else odebug "Swift returned unexpected exit status: #{exit_status}" :swift_unexpected_error end end [status, check_output] end |
.copy_xattrs(from, to, command:) ⇒ void
Этот метод является частью закрытого API. Этот метод можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого метода, поскольку он может быть удалён или изменён без предупреждения.
Этот метод возвращает неопределённое значение.
272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 | # File 'cask/quarantine.rb', line 272 def self.copy_xattrs(from, to, command:) odebug "Copying xattrs from #{from} to #{to}" raise "unexpected nil swift" unless swift command.run!( T.must(swift), args: [ *swift_target_args, COPY_XATTRS_SCRIPT, from, to, ], sudo: !to.writable?, ) end |
.detect(file) ⇒ Boolean?
Этот метод является частью закрытого API. Этот метод можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого метода, поскольку он может быть удалён или изменён без предупреждения.
114 115 116 117 118 119 120 121 122 123 124 | # File 'cask/quarantine.rb', line 114 def self.detect(file) return if file.nil? odebug "Verifying Gatekeeper status of #{file}" quarantine_status = !status(file).empty? odebug "#{file} is #{quarantine_status ? "quarantined" : "not quarantined"}" quarantine_status end |
.propagate(from: nil, to: nil) ⇒ void
Этот метод является частью закрытого API. Этот метод можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого метода, поскольку он может быть удалён или изменён без предупреждения.
Этот метод возвращает неопределённое значение.
231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 | # File 'cask/quarantine.rb', line 231 def self.propagate(from: nil, to: nil) return if from.nil? || to.nil? raise CaskError, "#{from} was not quarantined properly." unless detect(from) odebug "Propagating quarantine from #{from} to #{to}" quarantine_status = toggle_no_translocation_bit(status(from)) resolved_paths = Pathname.glob(to/"**/*", File::FNM_DOTMATCH).reject(&:symlink?) system_command!("/usr/bin/xargs", args: [ "-0", "--", "chmod", "-h", "u+w", ], input: resolved_paths.join("\0")) raise "unexpected nil xattr" unless xattr quarantiner = system_command("/usr/bin/xargs", args: [ "-0", "--", T.must(xattr), "-w", QUARANTINE_ATTRIBUTE, quarantine_status, ], input: resolved_paths.join("\0"), print_stderr: false) return if quarantiner.success? raise CaskQuarantinePropagationError.new(to, quarantiner.stderr) end |
.release!(download_path: nil) ⇒ void
Этот метод является частью закрытого API. Этот метод можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого метода, поскольку он может быть удалён или изменён без предупреждения.
Этот метод возвращает неопределённое значение.
180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 | # File 'cask/quarantine.rb', line 180 def self.release!(download_path: nil) return if !download_path || !detect(download_path) odebug "Releasing #{download_path} from quarantine" raise "unexpected nil xattr" unless xattr quarantiner = system_command(T.must(xattr), args: [ "-d", QUARANTINE_ATTRIBUTE, download_path, ], print_stderr: false) return if quarantiner.success? raise CaskQuarantineReleaseError.new(download_path, quarantiner.stderr) end |
.signing_identity(file) ⇒ SigningIdentity?
Этот метод является частью закрытого API. Этот метод можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого метода, поскольку он может быть удалён или изменён без предупреждения.
146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 | # File 'cask/quarantine.rb', line 146 def self.signing_identity(file) result = system_command("codesign", args: ["-dvvv", file], print_stderr: false) return unless result.success? identifier = T.let(nil, T.nilable(String)) team_identifier = T.let(nil, T.nilable(String)) result.merged_output.to_s.each_line do |line| case line.chomp when /\AIdentifier=(.+)\z/ identifier = Regexp.last_match(1) when /\ATeamIdentifier=(.+)\z/ team_identifier = Regexp.last_match(1) team_identifier = nil if team_identifier == "not set" end end SigningIdentity.new(identifier:, team_identifier:) end |
.status(file) ⇒ String
Этот метод является частью закрытого API. Этот метод можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого метода, поскольку он может быть удалён или изменён без предупреждения.
127 128 129 130 131 132 133 | # File 'cask/quarantine.rb', line 127 def self.status(file) raise "unexpected nil xattr" unless xattr system_command(T.must(xattr), args: ["-p", QUARANTINE_ATTRIBUTE, file], print_stderr: false).stdout.rstrip end |
.toggle_no_translocation_bit(attribute) ⇒ String
Этот метод является частью закрытого API. Этот метод можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого метода, поскольку он может быть удалён или изменён без предупреждения.
167 168 169 170 171 172 173 174 175 176 177 | # File 'cask/quarantine.rb', line 167 def self.toggle_no_translocation_bit(attribute) fields = attribute.split(";") # Fields: status, epoch, download agent, event ID # Let's toggle the app translocation bit, bit 8 # http://www.openradar.me/radar?id=5022734169931776 fields[0] = (fields.fetch(0).to_i(16) | 0x0100).to_s(16).rjust(4, "0") fields.join(";") end |
.user_approved?(file) ⇒ Boolean
Этот метод является частью закрытого API. Этот метод можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого метода, поскольку он может быть удалён или изменён без предупреждения.
136 137 138 139 140 141 142 143 | # File 'cask/quarantine.rb', line 136 def self.user_approved?(file) return false if xattr.nil? quarantine_status = status(file) return false if quarantine_status.empty? quarantine_status.split(";").fetch(0).to_i(16).anybits?(USER_APPROVED_FLAG) end |
© 2009–present Homebrew contributors
Licensed under the BSD 2-Clause License.
https://docs.brew.sh/rubydoc/Cask/Quarantine.html