class Gem::Platform
用于定位 Gem
安装的可用平台列表。
有关平台匹配的信息,请参阅“gem help platform”。
常量
- CURRENT
为打包 Ruby 平台构建的平台特定 gem。 这将被
Gem::Platform::local
替换。- RUBY
一个纯 Ruby gem,可以使用
Gem::Specification#extensions
构建二进制文件。
属性
cpu[RW]
os[RW]
version[RW]
公共类方法
installable?(spec) 点击切换源代码
# File rubygems/platform.rb, line 67 def self.installable?(spec) if spec.respond_to? :installable_platform? spec.installable_platform? else match_spec? spec end end
local(refresh: false) 点击切换源代码
# File rubygems/platform.rb, line 15 def self.local(refresh: false) return @local if @local && !refresh @local = begin arch = Gem.target_rbconfig["arch"] arch = "#{arch}_60" if /mswin(?:32|64)$/.match?(arch) new(arch) end end
match(platform) 点击切换源代码
# File rubygems/platform.rb, line 24 def self.match(platform) match_platforms?(platform, Gem.platforms) end
match_gem?(platform, gem_name) 点击切换源代码
# File rubygems/platform.rb, line 48 def self.match_gem?(platform, gem_name) raise "Not a string: #{gem_name.inspect}" unless String === gem_name if REUSE_AS_BINARY_ON_TRUFFLERUBY.include?(gem_name) match_platforms?(platform, [Gem::Platform::RUBY, Gem::Platform.local]) else match_platforms?(platform, Gem.platforms) end end
match_spec?(spec) 点击切换源代码
# File rubygems/platform.rb, line 43 def self.match_spec?(spec) match_gem?(spec.platform, spec.name) end
new(arch) 点击切换源代码
# File rubygems/platform.rb, line 86 def initialize(arch) case arch when Array then @cpu, @os, @version = arch when String then arch = arch.split "-" if arch.length > 2 && !arch.last.match?(/\d+(\.\d+)?$/) # reassemble x86-linux-{libc} extra = arch.pop arch.last << "-#{extra}" end cpu = arch.shift @cpu = case cpu when /i\d86/ then "x86" else cpu end if arch.length == 2 && arch.last.match?(/^\d+(\.\d+)?$/) # for command-line @os, @version = arch return end os, = arch if os.nil? @cpu = nil os = cpu end # legacy jruby @os, @version = case os when /aix(\d+)?/ then ["aix", $1] when /cygwin/ then ["cygwin", nil] when /darwin(\d+)?/ then ["darwin", $1] when /^macruby$/ then ["macruby", nil] when /freebsd(\d+)?/ then ["freebsd", $1] when /^java$/, /^jruby$/ then ["java", nil] when /^java([\d.]*)/ then ["java", $1] when /^dalvik(\d+)?$/ then ["dalvik", $1] when /^dotnet$/ then ["dotnet", nil] when /^dotnet([\d.]*)/ then ["dotnet", $1] when /linux-?(\w+)?/ then ["linux", $1] when /mingw32/ then ["mingw32", nil] when /mingw-?(\w+)?/ then ["mingw", $1] when /(mswin\d+)(\_(\d+))?/ then os = $1 version = $3 @cpu = "x86" if @cpu.nil? && os =~ /32$/ [os, version] when /netbsdelf/ then ["netbsdelf", nil] when /openbsd(\d+\.\d+)?/ then ["openbsd", $1] when /solaris(\d+\.\d+)?/ then ["solaris", $1] when /wasi/ then ["wasi", nil] # test when /^(\w+_platform)(\d+)?/ then [$1, $2] else ["unknown", nil] end when Gem::Platform then @cpu = arch.cpu @os = arch.os @version = arch.version else raise ArgumentError, "invalid argument #{arch.inspect}" end end
sort_priority(platform) 点击切换源代码
# File rubygems/platform.rb, line 63 def self.sort_priority(platform) platform == Gem::Platform::RUBY ? -1 : 1 end
私有类方法
match_platforms?(platform, platforms) 点击切换源代码
# File rubygems/platform.rb, line 33 def self.match_platforms?(platform, platforms) platform = Gem::Platform.new(platform) unless platform.is_a?(Gem::Platform) platforms.any? do |local_platform| platform.nil? || local_platform == platform || (local_platform != Gem::Platform::RUBY && platform =~ local_platform) end end
公共实例方法
==(other) 点击切换源代码
other
是否等于此平台? 如果两个平台具有相同的 CPU、操作系统和版本,则它们相等。
# File rubygems/platform.rb, line 164 def ==(other) self.class === other && to_a == other.to_a end
也别名为:eql?
===(other) 点击切换源代码
other
是否与此平台匹配? 如果两个平台具有相同的 CPU,或者其中一个的 CPU 为“universal”,它们具有相同的操作系统,并且它们具有相同的版本,或者其中一个没有版本,则它们匹配。
此外,如果本地 CPU 是“arm”并且另一个 CPU 以“armv”开头(用于通用 32 位 ARM 系列支持),则平台将匹配。
值得注意的是,此方法不可交换。 实际上,操作系统“linux”有一个特殊情况:版本是 libc 名称,但是当“无版本”作为二进制 gem 平台的通配符(与其他操作系统一样)时,对于运行时平台,“无版本”代表“gnu”。 为了能够区分这些,方法接收者是 gem 平台,而参数是运行时平台。
# File rubygems/platform.rb, line 192 def ===(other) return nil unless Gem::Platform === other # universal-mingw32 matches x64-mingw-ucrt return true if (@cpu == "universal" || other.cpu == "universal") && @os.start_with?("mingw") && other.os.start_with?("mingw") # cpu ([nil,"universal"].include?(@cpu) || [nil, "universal"].include?(other.cpu) || @cpu == other.cpu || (@cpu == "arm" && other.cpu.start_with?("armv"))) && # os @os == other.os && # version ( (@os != "linux" && (@version.nil? || other.version.nil?)) || (@os == "linux" && (normalized_linux_version == other.normalized_linux_version || ["musl#{@version}", "musleabi#{@version}", "musleabihf#{@version}"].include?(other.version))) || @version == other.version ) end
=~(other) 点击切换源代码
other
是否与此平台匹配? 如果 other
是一个字符串,它将首先转换为 Gem::Platform
。 有关匹配规则,请参阅 ===
。
# File rubygems/platform.rb, line 230 def =~(other) case other when Gem::Platform then # nop when String then # This data is from http://gems.rubyforge.org/gems/yaml on 19 Aug 2007 other = case other when /^i686-darwin(\d)/ then ["x86", "darwin", $1] when /^i\d86-linux/ then ["x86", "linux", nil] when "java", "jruby" then [nil, "java", nil] when /^dalvik(\d+)?$/ then [nil, "dalvik", $1] when /dotnet(\-(\d+\.\d+))?/ then ["universal","dotnet", $2] when /mswin32(\_(\d+))?/ then ["x86", "mswin32", $2] when /mswin64(\_(\d+))?/ then ["x64", "mswin64", $2] when "powerpc-darwin" then ["powerpc", "darwin", nil] when /powerpc-darwin(\d)/ then ["powerpc", "darwin", $1] when /sparc-solaris2.8/ then ["sparc", "solaris", "2.8"] when /universal-darwin(\d)/ then ["universal", "darwin", $1] else other end other = Gem::Platform.new other else return nil end self === other end
normalized_linux_version() 点击切换源代码
# File rubygems/platform.rb, line 217 def normalized_linux_version return nil unless @version without_gnu_nor_abi_modifiers = @version.sub(/\Agnu/, "").sub(/eabi(hf)?\Z/, "") return nil if without_gnu_nor_abi_modifiers.empty? without_gnu_nor_abi_modifiers end
to_a() 点击切换源代码
# File rubygems/platform.rb, line 152 def to_a [@cpu, @os, @version] end
to_s() 点击切换源代码
# File rubygems/platform.rb, line 156 def to_s to_a.compact.join "-" end