Class: RubyWasm::Packager::Core::StaticLinking

Inherits:

BuildStrategy

• Object
• BuildStrategy
• RubyWasm::Packager::Core::StaticLinking

Defined in:

lib/ruby_wasm/packager/core.rb

Instance Method Summary

• #artifact ⇒ Object
• #build(executor, options) ⇒ Object
• #build_gem_exts(executor, gem_home) ⇒ Object
• #cache_key(digest) ⇒ Object
• #derive_build ⇒ Object
• #link_gem_exts(executor, ruby_root, gem_home, module_bytes) ⇒ Object
• #name ⇒ Object
• #target ⇒ Object
• #user_exts(build) ⇒ Object

Methods inherited from BuildStrategy

#initialize, #specs_with_extensions, #wasi_exec_model

Constructor Details

This class inherits a constructor from RubyWasm::Packager::Core::BuildStrategy

Instance Method Details

#artifact ⇒ Object

# File 'lib/ruby_wasm/packager/core.rb', line 297

def artifact
  derive_build.crossruby.artifact
end

#build(executor, options) ⇒ Object

# File 'lib/ruby_wasm/packager/core.rb', line 263

def build(executor, options)
  build = derive_build
  force_rebuild =
    options[:remake] || options[:clean] || options[:reconfigure]
  if File.exist?(build.crossruby.artifact) && !force_rebuild
    return build.crossruby.artifact
  end
  build.crossruby.clean(executor) if options[:clean]

  do_build =
    proc do
      build.crossruby.build(
        executor,
        remake: options[:remake],
        reconfigure: options[:reconfigure]
      )
    end

  __skip__ =
    if defined?(Bundler)
      Bundler.with_unbundled_env(&do_build)
    else
      do_build.call
    end
  build.crossruby.artifact
end

#build_gem_exts(executor, gem_home) ⇒ Object

# File 'lib/ruby_wasm/packager/core.rb', line 334

def build_gem_exts(executor, gem_home)
  # No-op because we already built extensions as part of the Ruby build
end

#cache_key(digest) ⇒ Object

# File 'lib/ruby_wasm/packager/core.rb', line 290

def cache_key(digest)
  derive_build.cache_key(digest)
  if enabled = @packager.features.support_component_model?
    digest << enabled.to_s
  end
end

#derive_build ⇒ Object

# File 'lib/ruby_wasm/packager/core.rb', line 305

def derive_build
  return @build if @build
  __skip__ = build ||= RubyWasm::Build.new(
    name, **@packager.full_build_options, target: target,
  )
  build.crossruby.user_exts = user_exts(build)
  # Emscripten uses --global-base=1024 by default, but it conflicts with
  # --stack-first and -z stack-size since global-base 1024 is smaller than
  # the large stack size.
  # Also -g produces some warnings on Emscripten and it confuses the configure
  # script of Ruby.
  if @packager.full_build_options[:target] != "wasm32-unknown-emscripten"
    build.crossruby.debugflags = %w[-g]
    # We assume that imported functions provided through WASI will not change
    # asyncify state, so we ignore them.
    build.crossruby.wasmoptflags = %w[-O3 -g --pass-arg=asyncify-ignore-imports]
    build.crossruby.ldflags = %w[
      -Xlinker
      --stack-first
      -Xlinker
      -z
      -Xlinker
      stack-size=16777216
    ]
  end
  @build = build
  build
end

#link_gem_exts(executor, ruby_root, gem_home, module_bytes) ⇒ Object

# File 'lib/ruby_wasm/packager/core.rb', line 338

def link_gem_exts(executor, ruby_root, gem_home, module_bytes)
  return module_bytes unless @packager.features.support_component_model?

  linker = RubyWasmExt::ComponentEncode.new
  linker.validate(ENV["RUBYWASM_SKIP_LINKER_VALIDATION"] != "1")
  linker.module(module_bytes)
  linker.adapter(
    "wasi_snapshot_preview1",
    File.binread(RubyWasm::Packager::ComponentAdapter.wasi_snapshot_preview1(wasi_exec_model))
  )

  linker.encode()
end

#name ⇒ Object

# File 'lib/ruby_wasm/packager/core.rb', line 369

def name
  require "digest"
  options = @packager.full_build_options
  src_channel = options[:src][:name]
  target_triplet = options[:target]
  base = "ruby-#{src_channel}-#{target_triplet}#{options[:suffix]}"
  exts = specs_with_extensions.sort
  hash = ::Digest::MD5.new
  specs_with_extensions.each { |spec, _| hash << spec.full_name }
  if enabled = @packager.features.support_component_model?
    hash << enabled.to_s
  end
  exts.empty? ? base : "#{base}-#{hash.hexdigest}"
end

#target ⇒ Object

# File 'lib/ruby_wasm/packager/core.rb', line 301

def target
  RubyWasm::Target.new(@packager.full_build_options[:target])
end

#user_exts(build) ⇒ Object

# File 'lib/ruby_wasm/packager/core.rb', line 352

def user_exts(build)
  @user_exts ||=
    specs_with_extensions.flat_map do |spec, exts|
      exts.map do |ext|
        ext_feature = File.dirname(ext) # e.g. "ext/cgi/escape"
        ext_srcdir = File.join(spec.full_gem_path, ext_feature)
        ext_relative_path = File.join(spec.full_name, ext_feature)
        RubyWasm::CrossRubyExtProduct.new(
          ext_srcdir,
          build.toolchain,
          features: @packager.features,
          ext_relative_path: ext_relative_path
        )
      end
    end
end