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
eql?(other)
别名为:==
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