9cbee5e4bd
Per user design: on_build(build) is the build-callback registrar (a free fn), generalizing set_post_link_callback — the callback is (opt: BuildOptions) -> bool and the compiler invokes it post-codegen WITH the BuildOptions handle. - VM: callCompilerFn 'on_build' arm + legacy handleOnBuild, both set post_link_callback_fn + a new BuildConfig.post_link_takes_options flag. - comptime_vm: runEntry refactored to runEntryArgs(extra) (implicit ctx + explicit args); new public runBuildCallback(..., pass_options) passes the opaque BuildOptions handle (one word) after the ctx. The fat-config marshaling fear is moot — the handle is a single null-sentinel word. - core.invokeByFuncId/invokeByName take pass_options (was an unused args slice); main.zig passes comp.getPostLinkTakesOptions(). - build.sx: on_build decl (set_post_link_callback kept for now). Smoke test examples/1664-platform-on-build-callback (AOT): #run on_build(build) with build :: (opt: BuildOptions) -> bool; the callback is invoked with the handle arg (runEntryArgs param-count match) and runs the primitives. Benign .ir churn (37 snapshots: type table +1 for the on_build fn type + global renumber; behavior identical). 705/0 both gates.
105 lines
5.4 KiB
Plaintext
105 lines
5.4 KiB
Plaintext
OperatingSystem :: enum { macos; linux; windows; wasm; ios; android; unknown; }
|
|
Architecture :: enum { aarch64; x86_64; wasm32; wasm64; unknown; }
|
|
|
|
OS : OperatingSystem = .unknown;
|
|
ARCH : Architecture = .unknown;
|
|
POINTER_SIZE : i64 = 8;
|
|
|
|
BuildOptions :: struct #compiler {
|
|
add_link_flag :: (self: BuildOptions, flag: [:0]u8);
|
|
add_framework :: (self: BuildOptions, name: [:0]u8);
|
|
set_output_path :: (self: BuildOptions, path: [:0]u8);
|
|
set_wasm_shell :: (self: BuildOptions, path: [:0]u8);
|
|
|
|
// Register a directory of runtime assets to bundle alongside the
|
|
// binary. `src` is the path on disk (relative to the CWD at build
|
|
// time); `dest` is the relative location inside the bundle / APK.
|
|
// Apple .app: copied to `<bundle>/<dest>/`. Android APK (Week 7):
|
|
// zipped under `<dest>/` at the APK root. Idiomatic chess form is
|
|
// `opts.add_asset_dir("assets", "assets")`.
|
|
add_asset_dir :: (self: BuildOptions, src: [:0]u8, dest: [:0]u8);
|
|
asset_dir_count :: (self: BuildOptions) -> i64;
|
|
asset_dir_src_at :: (self: BuildOptions, i: i64) -> string;
|
|
asset_dir_dest_at :: (self: BuildOptions, i: i64) -> string;
|
|
|
|
// Name-based alternative to `set_post_link_callback`. The
|
|
// compiler resolves `<module_name>.bundle_main` after linking.
|
|
set_post_link_module :: (self: BuildOptions, module_name: [:0]u8);
|
|
|
|
// Path of the freshly-linked binary, only meaningful while a
|
|
// post-link callback is running. Returns "" before linking.
|
|
binary_path :: (self: BuildOptions) -> string;
|
|
|
|
// Apple `.app` / Android `.apk` bundling parameters. Accessors
|
|
// return "" when unset so the bundler can use a single string
|
|
// type. macOS bundling needs `bundle_path` and `bundle_id`;
|
|
// codesign / provisioning are iOS-device-only.
|
|
set_bundle_path :: (self: BuildOptions, path: [:0]u8);
|
|
set_bundle_id :: (self: BuildOptions, id: [:0]u8);
|
|
set_codesign_identity :: (self: BuildOptions, identity: [:0]u8);
|
|
set_provisioning_profile :: (self: BuildOptions, path: [:0]u8);
|
|
|
|
bundle_path :: (self: BuildOptions) -> string;
|
|
bundle_id :: (self: BuildOptions) -> string;
|
|
codesign_identity :: (self: BuildOptions) -> string;
|
|
provisioning_profile :: (self: BuildOptions) -> string;
|
|
|
|
// Target accessors. Empty triple before linking; predicates mirror
|
|
// TargetConfig.is{MacOS,IOS,IOSDevice,IOSSimulator}() on the Zig
|
|
// side. Used by the sx bundler to switch Info.plist shape and
|
|
// codesigning ceremony per platform.
|
|
target_triple :: (self: BuildOptions) -> string;
|
|
is_macos :: (self: BuildOptions) -> bool;
|
|
is_ios :: (self: BuildOptions) -> bool;
|
|
is_ios_device :: (self: BuildOptions) -> bool;
|
|
is_ios_simulator :: (self: BuildOptions) -> bool;
|
|
is_android :: (self: BuildOptions) -> bool;
|
|
|
|
// Framework list accessors. The bundler walks `framework_count() *
|
|
// framework_at(i)` to find each `-framework` name and recursively
|
|
// copies its `<Name>.framework` directory from one of
|
|
// `framework_path_at(0..framework_path_count())` into
|
|
// `<bundle>/Frameworks/`. Slice returns aren't natively expressible
|
|
// through the compiler-hook bridge yet, hence the indexed form.
|
|
framework_count :: (self: BuildOptions) -> i64;
|
|
framework_at :: (self: BuildOptions, i: i64) -> string;
|
|
framework_path_count :: (self: BuildOptions) -> i64;
|
|
framework_path_at :: (self: BuildOptions, i: i64) -> string;
|
|
|
|
// Android APK bundling parameters. `manifest_path` overrides the
|
|
// bundler's auto-generated AndroidManifest.xml; `keystore_path`
|
|
// overrides the default `$HOME/.android/debug.keystore`. Accessors
|
|
// return "" when unset.
|
|
set_manifest_path :: (self: BuildOptions, path: [:0]u8);
|
|
set_keystore_path :: (self: BuildOptions, path: [:0]u8);
|
|
manifest_path :: (self: BuildOptions) -> string;
|
|
keystore_path :: (self: BuildOptions) -> string;
|
|
|
|
// `#jni_main #jni_class("path") { ... }` decls collected during
|
|
// lowering. The Android bundler walks `0..jni_main_count()` and
|
|
// for each entry writes a `.java` file at
|
|
// `<stage>/java/<runtime_path>.java`, compiles via javac + d8, and
|
|
// bundles the resulting classes.dex into the APK.
|
|
jni_main_count :: (self: BuildOptions) -> i64;
|
|
jni_main_runtime_path_at :: (self: BuildOptions, i: i64) -> string;
|
|
jni_main_java_source_at :: (self: BuildOptions, i: i64) -> string;
|
|
}
|
|
|
|
build_options :: () -> BuildOptions abi(.compiler);
|
|
|
|
// Post-link callback. Registers a sx function the compiler will invoke after
|
|
// `target.link()` returns. Used by the sx-side bundler
|
|
// (`platform.bundle.bundle_main`) and by user programs that want custom
|
|
// post-build steps. Return `false` to fail the build. Migrated off `#compiler`
|
|
// onto the comptime compiler-API (`abi(.compiler)`); called as
|
|
// `opts.set_post_link_callback(cb)` via UFCS, from inside a `#run { … }` block.
|
|
set_post_link_callback :: ufcs (self: BuildOptions, cb: () -> bool) abi(.compiler);
|
|
|
|
// The build callback registrar (Phase 5). Registers the sx function that drives
|
|
// the build — the compiler invokes it after codegen with the `BuildOptions`
|
|
// handle. Generalizes `set_post_link_callback` (a free fn, and the callback
|
|
// receives `opt`); `#run on_build(build);` is the override form, where
|
|
// `build :: (opt: BuildOptions) -> bool abi(.compiler) { … }`. The stdlib default
|
|
// implementation lives below (the default `build` script).
|
|
on_build :: (cb: (opt: BuildOptions) -> bool abi(.compiler)) abi(.compiler);
|