Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
614392c921 | ||
|
|
45ca185094 | ||
|
|
cf79e89dc4 | ||
|
|
1aa218d0bb | ||
|
|
8913022044 | ||
|
|
2b556a4a58 |
No files matched your search
@@ -1,176 +1,73 @@
|
|||||||
# OGS applications (`mj`)
|
# OGS applications (`mj`)
|
||||||
|
|
||||||
Native SwiftUI applications using the Dialect v4 declarative reactive engine.
|
Native SwiftUI and Compose apps on the Dialect v4 declarative reactive engine.
|
||||||
Version: `2.0.0`. Remote: `https://git.opengamestudio.org/mahjong/mahjong`.
|
Remote: `https://git.opengamestudio.org/mahjong/mahjong`.
|
||||||
|
|
||||||
## Current status
|
## Apps
|
||||||
|
|
||||||
- `ogs-blue/` is the active minimal graphics example for macOS and iOS: a solid
|
- `hello/hello-platform/` — macOS + iOS + Android platform-support sample (Hello counter). Its
|
||||||
blue raylib background with a SwiftUI overlay. It has no model/texture/shadow
|
structure, startup flow and dialect rules are in
|
||||||
scene; rlgl still creates its default internal GPU resources.
|
[docs/hello-platform.md](docs/hello-platform.md); read that file whenever anything
|
||||||
- `ogs-mahjong/` contains the macOS Mahjong scaffold and counter-template logic;
|
from hello-platform is referenced.
|
||||||
Mahjong gameplay has not been implemented.
|
|
||||||
- `ogs-chkgfx/` is a companion graphics scaffold with macOS/iOS project files.
|
|
||||||
Older targets can lag behind shared-component changes; verify each target
|
|
||||||
separately before claiming it builds.
|
|
||||||
- The previous `game/ver-mac` and root `dialect.yml` layout is obsolete.
|
|
||||||
|
|
||||||
## Source layout
|
## Layout
|
||||||
|
|
||||||
- `<app>/dialect.yml`: per-application logic; generates
|
- `<app>/dialect.yml` → generates `<app>/ver-mac/src/dialect.swift` and
|
||||||
`<app>/ver-mac/src/dialect.swift`. Blue iOS links to its macOS generated file.
|
`<app>/ver-android/.../dialect.kt`.
|
||||||
- `components/`: shared source of truth. App `src/` files use relative symlinks;
|
- `components/` — shared source of truth; app `src/` entries are relative symlinks:
|
||||||
edit real component files and preserve symlink parity.
|
edit the real files and keep symlink parity.
|
||||||
- `components/render/`: shared component/model/constants, plus mirrored `ios/`
|
- `hello-platform` uses `components/hp/` for its component, view models and views
|
||||||
and `mac/` effects, helpers and native/SwiftUI views. macOS additionally has
|
(`mac/`, `ios/`, `android/`), and `components/other/` for shared helpers.
|
||||||
`renderConstMac.swift` for native pixel-format attributes.
|
- `history/gitjs/` — historical JS reference, outside the build.
|
||||||
- `components/raybri/raybri.h`: declarations plus implementation gated by
|
|
||||||
`RAYBRI_IMPLEMENTATION`; clears blue, renders and shuts down rlgl.
|
|
||||||
- `components/raybri/raybriConst.h`: shared constants with an implementation macro.
|
|
||||||
`components/raybri/mac/raybriAux.h`: macOS OpenGL symbol loader.
|
|
||||||
- `components/egl/egl.h` and `eglConst.h`: EGL state/helpers and configuration,
|
|
||||||
using single-header implementation macros.
|
|
||||||
- `ogs-blue/ver-{mac,ios}/src/Blue.c`: platform C implementation translation units.
|
|
||||||
- `history/gitjs/`: historical JavaScript Mahjong reference, outside the build.
|
|
||||||
`ref/swiftraylib` links to the sibling renderer sample.
|
|
||||||
|
|
||||||
## Graphics ownership and platform differences
|
## Build
|
||||||
|
|
||||||
Every GPU operation requires its context current on the calling thread.
|
Prereqs: sibling `../dialect` checkout (`util/build-generator`).
|
||||||
`rlLoadExtensions` also requires an existing current context; it precedes
|
|
||||||
`rlglInit`, not native context creation.
|
|
||||||
|
|
||||||
macOS uses `NSOpenGLView` (OpenGL 3.2 Core). `renderInit` makes its context
|
|
||||||
current, enables VSync, loads extensions with the C loader callback and starts
|
|
||||||
raylib. The timer requests `needsDisplay`; `draw(_:)` forwards to `renderDraw`,
|
|
||||||
which activates the context, renders and presents via `flushBuffer`.
|
|
||||||
|
|
||||||
Blue's SPM `RaylibBridge` target compiles `src/Blue.c`, exposes headers in
|
|
||||||
`src/raybri`, and links Homebrew raylib. It does NOT define
|
|
||||||
`RLGL_IMPLEMENTATION`: Homebrew headers omit the `external/glad.h` needed to
|
|
||||||
compile desktop rlgl locally. Swift imports `RaylibBridge`. `RAYLIB_PREFIX`
|
|
||||||
defaults to `/opt/homebrew`; build scripts detect `brew --prefix raylib`.
|
|
||||||
The installed raylib may produce a deployment-target linker warning.
|
|
||||||
|
|
||||||
On iOS, UIKit owns the view/layer and `RenderGLView.st` owns an `EGLState`.
|
|
||||||
Swift effects create EGL/ANGLE state and surface, make the context current,
|
|
||||||
and initialize raylib. Timer ticks call rendering directly; presentation uses
|
|
||||||
`eglSwapBuffers`. Pixel sizes come from view bounds and content scale.
|
|
||||||
Dialect's resize event triggers `renderRecreateSurface`; the macOS helper is
|
|
||||||
intentionally a no-op. Teardown must stop the timer, activate the context,
|
|
||||||
release rlgl resources, then destroy EGL surface/context/display resources.
|
|
||||||
|
|
||||||
Blue iOS uses `src/BlueBridgingHeader.h` to expose C APIs to Swift. `Blue.c`
|
|
||||||
compiles EGL helpers and rlgl using their implementation macros exactly once.
|
|
||||||
It uses the raylib-iOS XCFramework headers but does not link its full raylib
|
|
||||||
library. The app links/embeds `libEGL` and `libGLESv2` (ANGLE's Metal backend).
|
|
||||||
The XcodeGen settings define `PLATFORM_IOS`, `GRAPHICS_API_OPENGL_ES3`, and
|
|
||||||
`GL_GLEXT_PROTOTYPES`. Minimum iOS is 15.0; portrait and both landscape
|
|
||||||
orientations are enabled in Blue's Info.plist.
|
|
||||||
|
|
||||||
## Build and prerequisites
|
|
||||||
|
|
||||||
- macOS: `brew install raylib`.
|
|
||||||
- iOS project generation: `brew install xcodegen`; supply sibling
|
|
||||||
`../raylib-ios-xcframeworks` containing raylib/libEGL/libGLESv2 XCFrameworks.
|
|
||||||
`checkRaylibIOS` checks presence; it does not download them.
|
|
||||||
- Dialect: sibling `../dialect`, built with `(cd ../dialect && util/build-generator)`.
|
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
util/build-ogs-blue-mac
|
cd hello/hello-platform
|
||||||
util/run-ogs-blue-mac
|
util/build-mac
|
||||||
util/prepare-ogs-blue-ios
|
util/run-mac
|
||||||
|
util/prepare-ios # xcodegen; xcodebuild command is in docs/hello-platform.md
|
||||||
|
util/prepare-android # generate dialect.kt; gradlew command is in docs/hello-platform.md
|
||||||
```
|
```
|
||||||
|
|
||||||
The corresponding macOS build/run scripts also exist for `ogs-chkgfx` and
|
`build-mac` regenerates Dialect, runs `swift build` in `ver-mac/`, then packages the
|
||||||
`ogs-mahjong`; `prepare-ogs-chkgfx-ios` exists as well. Inspect their individual
|
binary and `ver-mac/res/` into `ver-mac/.build/<App Name>.app`. `ver-ios/` mirrors
|
||||||
configuration before assuming parity with Blue.
|
`ver-mac/` and shares `dialect.swift`, `HPView` and the app icon via symlinks.
|
||||||
|
`ver-android/` has its own generated `dialect.kt` and Compose view. Kotlin output is
|
||||||
|
LLM-transpiled: run `ollama serve` before generating (model `qwen2.5-coder:3b`).
|
||||||
|
Dangling-symlink audit:
|
||||||
|
`find components hello -type l ! -exec test -e {} \; -not -path '*/.build/*'`
|
||||||
|
|
||||||
macOS build scripts generate Dialect, run `swift build`, and package resources
|
iOS simulator: use **IVA** (`EB867790-F2C0-4392-9F99-C509D4487FDA`, iPhone 17,
|
||||||
from `ver-mac/res/` into `ver-mac/.build/<App Name>.app`. iOS preparation checks
|
iOS 26.5), not iPhone 15 Pro. Android emulator: **Small_30** (`-gpu
|
||||||
XCFrameworks, generates Dialect, stages ANGLE include/library symlinks in
|
swiftshader_indirect` avoids a headless crash).
|
||||||
`ver-ios/.build/`, then runs XcodeGen. Build Blue for Simulator with:
|
|
||||||
|
|
||||||
```sh
|
## Dialect
|
||||||
xcodebuild -project 'ogs-blue/ver-ios/OGS blue.xcodeproj' -scheme ogs-blue \
|
|
||||||
-sdk iphonesimulator -destination 'generic/platform=iOS Simulator' \
|
|
||||||
CODE_SIGNING_ALLOWED=NO build
|
|
||||||
```
|
|
||||||
|
|
||||||
Audit dangling source symlinks after moves (SPM can silently skip them):
|
- Edit `<app>/dialect.yml` / `components/`, then `util/build-mac`; manual edits to the
|
||||||
|
generated `dialect.swift` / `dialect.kt` are overwritten.
|
||||||
```sh
|
- `struct F` (field names) exists only in the generated files: a new field needs
|
||||||
find components ogs-blue ogs-chkgfx ogs-mahjong -type l ! -exec test -e {} \; -not -path '*/.build/*'
|
`static let <field> = "<field>"` hand-patched in ASCII order in both
|
||||||
```
|
`dialect.swift` and `dialect.kt` or `F.<field>` will not build.
|
||||||
|
- Validate: `ruby -ryaml -e 'YAML.load_file("hello/hello-platform/dialect.yml")'`.
|
||||||
## Editing the dialect
|
Every should-label (`1. Upon each ...`) MUST end with a colon —
|
||||||
|
`../dialect/components/yml/ymlFun.swift` blindly `dropLast()`s it. Complaints
|
||||||
- Add/modify contexts and components in `<app>/dialect.yml`, then run
|
inside `if:`/`then:` (unquoted `: `) are expected.
|
||||||
`util/build-<app>-mac` to regenerate `dialect.swift`.
|
|
||||||
- **Chicken-egg**: `struct F` (field-name constants) lives only in the
|
|
||||||
generated `dialect.swift`. Adding a new field to a context in `<app>/dialect.yml`
|
|
||||||
requires hand-patching its `static let <field> = "<field>"` into `struct F`
|
|
||||||
in `dialect.swift` (ASCII-alphabetical order) if you cannot regenerate first,
|
|
||||||
otherwise the build fails on `F.<field>` being unresolved.
|
|
||||||
- `dialect.swift` is generated — edits there are overwritten on the next
|
|
||||||
`util/build-<app>-mac`. Change the source (`<app>/dialect.yml` / `components/`) instead.
|
|
||||||
- **Validate `<app>/dialect.yml` after edits** (e.g. `ruby -ryaml -e 'YAML.load_file("ogs-blue/dialect.yml")'`).
|
|
||||||
Every should-branch label (`1. Upon each ...`) MUST end with a colon — the
|
|
||||||
parser (`components/yml/ymlFun.swift`) blindly `dropLast()`s it, so a missing
|
|
||||||
colon silently eats the label's last character in the generated `about`
|
|
||||||
comment. Note the file can never pass a *strict* YAML parser: condition and
|
|
||||||
reaction lines (under `if:` / `then:`) contain unquoted `: ` (e.g.
|
|
||||||
`c.countText = "Count: '\(c.count)'"`), which standard YAML rejects. So treat
|
|
||||||
a parser complaint pointing *inside* an `if:`/`then:` block as expected; any
|
|
||||||
complaint elsewhere (like a missing branch-label colon) is a real bug.
|
|
||||||
|
|
||||||
## Swift 6
|
|
||||||
|
|
||||||
The project currently builds in Swift 5 language mode
|
|
||||||
(`util/step/buildMac` has the Swift 6 flag commented out). Enabling
|
|
||||||
`-Xswiftc -swift-version -Xswiftc 6` fails today on the singleton/`@MainActor`
|
|
||||||
concurrency errors (`RootComponent.singleton`, `RootVM.shared` in
|
|
||||||
`components/root/`, `RenderComponent.singleton`, `RenderVM.shared` in
|
|
||||||
`components/render/`, and the `RootVM.shared!.countText = ...` /
|
|
||||||
`RenderVM.shared!.pixelSize = ...` oneliners in the generated `dialect.swift`).
|
|
||||||
Do not flip it on without addressing those.
|
|
||||||
|
|
||||||
## Conventions
|
## Conventions
|
||||||
|
|
||||||
- When generating or mirroring Swift/iOS code into Android, stay as close to
|
- Mirror Swift/iOS into Android (naming, text, layout, styling).
|
||||||
the Swift original as possible: preserve naming, capitalization, visible text,
|
- Compose: named `MaterialTheme.typography` styles over `fontSize`.
|
||||||
layout, styling, behavior and structure. Use the closest platform equivalent
|
- Kotlin: wildcard imports for multiple declarations from one package, including
|
||||||
where a direct translation is unavailable; avoid unrelated redesigns or
|
generated ones; subpackages need separate imports.
|
||||||
Android-specific changes unless requested. In particular, use `OGS blue`
|
- `.build/`, `build/`, `.DS_Store`, Xcode/Gradle artifacts are git-ignored.
|
||||||
(not `OGS Blue`) for the Android project name and app labels, matching iOS.
|
|
||||||
|
|
||||||
- Android Compose typography: prefer named `MaterialTheme.typography` styles
|
## Source studies
|
||||||
over explicit numeric `fontSize` values. Use `headlineLarge` for Blue's title
|
|
||||||
as the counterpart to SwiftUI's `.largeTitle`, on both overlaid text layers.
|
|
||||||
|
|
||||||
- Android Kotlin imports: use wildcard imports (`package.*`) when importing
|
Follow [docs/file-summary.md](docs/file-summary.md) (single-file) and
|
||||||
multiple declarations from the same package, including newly generated imports.
|
[docs/mirror-summary.md](docs/mirror-summary.md) (mirrored platforms: one
|
||||||
Keep single imports and aliases explicit where needed to avoid name conflicts.
|
self-contained HTML with aligned function starts, original line numbers, green/orange
|
||||||
Wildcards do not include subpackages; import those separately.
|
fills, counts, non-repetitive explanations); never substitute working-tree code for a
|
||||||
|
requested historical revision.
|
||||||
- `game/ver-mac/.build/`, `build/`, `.DS_Store`, Xcode/Gradle artifacts are
|
|
||||||
git-ignored.
|
|
||||||
- Prefer editing files in `components/` (the real files); the `src/` entries are
|
|
||||||
symlinks.
|
|
||||||
- The generated UI callback plumbing is nonisolated; UI singletons are weak
|
|
||||||
(`RootComponent.singleton`, `RootVM.shared`, `RenderComponent.singleton`,
|
|
||||||
`RenderVM.shared`) and are accessed from the generated oneliners with
|
|
||||||
force-unwrap (`RootVM.shared!.countText = ...`, `RenderVM.shared!.pixelSize = ...`).
|
|
||||||
- Never call raylib / `raybri_*` without making the view's GL context current first
|
|
||||||
(see the GL context rule above).
|
|
||||||
|
|
||||||
## Source study documents
|
|
||||||
|
|
||||||
- Single-file source studies: follow [docs/file-summary.md](docs/file-summary.md).
|
|
||||||
- Mirrored platform studies: follow [docs/mirror-summary.md](docs/mirror-summary.md).
|
|
||||||
Produce one self-contained downloadable HTML with aligned function starts,
|
|
||||||
original line numbers, green/orange number fills, counts/percentages and a
|
|
||||||
non-repetitive explanation column.
|
|
||||||
- Existing mirrored example: `docs/render-platform-comparison.html`, documenting
|
|
||||||
the revision named in its header. Never silently substitute working-tree code
|
|
||||||
for a requested historical revision.
|
|
||||||
@@ -1,8 +1,3 @@
|
|||||||
## Targets
|
|
||||||
|
|
||||||
| № | Target | macOS | iOS/iPadOS | Android |
|
|
||||||
| 1 | ogs-blue | √ | √ | ? |
|
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
### macOS
|
### macOS
|
||||||
@@ -14,4 +9,24 @@
|
|||||||
* `brew install xcodegen`
|
* `brew install xcodegen`
|
||||||
* ghera's [raylib-ios-xcframeworks][rzip] release unpacked and placed alongside the project
|
* ghera's [raylib-ios-xcframeworks][rzip] release unpacked and placed alongside the project
|
||||||
|
|
||||||
|
### Android
|
||||||
|
|
||||||
|
* Android Studio Quail 3 (2026.1.3)
|
||||||
|
|
||||||
|
### Linux
|
||||||
|
|
||||||
|
* Ubuntu 24.04
|
||||||
|
* [Swiftly][swiftly] + Swift (installed by Swiftly)
|
||||||
|
* Swift dependencies (proposed by Swiftly after Swift installation)
|
||||||
|
`apt-get -y install binutils git gnupg2 libcurl4-openssl-dev libgcc-13-dev libpython3-dev libstdc++-13-dev libxml2-dev libncurses-dev libz3-dev pkg-config zlib1g-dev`
|
||||||
|
* CrossSwiftUI dependency
|
||||||
|
`apt-get -y install libgtk-4-dev`
|
||||||
|
|
||||||
|
## Components
|
||||||
|
|
||||||
|
| Component | macOS | iOS | Android | Linux | Windows | Description |
|
||||||
|
| --- | --- | --- | --- | --- | --- | --- |
|
||||||
|
| hp | √ | √ | √ | ? | | **h**ello-**p**latform is a simple UI to validate platform support |
|
||||||
|
|
||||||
[rzip]: https://github.com/ghera/raylib-iOS/releases/download/6.2.0-iOS/raylib-ios-xcframeworks-6.2.0-iOS.zip
|
[rzip]: https://github.com/ghera/raylib-iOS/releases/download/6.2.0-iOS/raylib-ios-xcframeworks-6.2.0-iOS.zip
|
||||||
|
[swiftly]: https://www.swift.org/install/linux/
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
package org.opengamestudio
|
||||||
|
|
||||||
|
object HPComponent {
|
||||||
|
val ctrl = DialectController(HPContext())
|
||||||
|
|
||||||
|
init {
|
||||||
|
hpRegisterEffects(ctrl)
|
||||||
|
hpRegisterShoulds(ctrl)
|
||||||
|
}
|
||||||
|
|
||||||
|
fun setup() {
|
||||||
|
hpSet(F.didSetup, true)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
package org.opengamestudio
|
||||||
|
|
||||||
|
import androidx.compose.runtime.*
|
||||||
|
|
||||||
|
object HPVM {
|
||||||
|
var countText by mutableStateOf("")
|
||||||
|
|
||||||
|
var shared: HPVM? = this
|
||||||
|
private set
|
||||||
|
}
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
package org.opengamestudio
|
||||||
|
|
||||||
|
import androidx.compose.foundation.layout.*
|
||||||
|
import androidx.compose.material3.*
|
||||||
|
import androidx.compose.runtime.Composable
|
||||||
|
import androidx.compose.ui.*
|
||||||
|
import androidx.compose.ui.text.font.FontFamily
|
||||||
|
import androidx.compose.ui.unit.dp
|
||||||
|
|
||||||
|
@Composable
|
||||||
|
fun HPView() {
|
||||||
|
Column(
|
||||||
|
horizontalAlignment = Alignment.CenterHorizontally,
|
||||||
|
modifier = Modifier.padding(40.dp),
|
||||||
|
verticalArrangement = Arrangement.spacedBy(16.dp)
|
||||||
|
) {
|
||||||
|
Text(
|
||||||
|
style = MaterialTheme.typography.headlineLarge,
|
||||||
|
text = "Hello, platform!"
|
||||||
|
)
|
||||||
|
|
||||||
|
Text(
|
||||||
|
fontFamily = FontFamily.Monospace,
|
||||||
|
style = MaterialTheme.typography.titleMedium,
|
||||||
|
text = HPVM.countText
|
||||||
|
)
|
||||||
|
|
||||||
|
Button(
|
||||||
|
onClick = { hpSet(F.didClickIncrement, true) }
|
||||||
|
) {
|
||||||
|
Text("Increment")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
class HPComponent {
|
||||||
|
let ctrl = DialectController(HPContext())
|
||||||
|
static private(set) weak var singleton: HPComponent?
|
||||||
|
|
||||||
|
init() {
|
||||||
|
Self.singleton = self
|
||||||
|
hpRegisterEffects(ctrl)
|
||||||
|
hpRegisterShoulds(ctrl)
|
||||||
|
}
|
||||||
|
|
||||||
|
func setup() {
|
||||||
|
hpSet(F.didSetup, true)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
import Combine
|
||||||
|
|
||||||
|
final class HPVM: ObservableObject {
|
||||||
|
@Published var countText = ""
|
||||||
|
|
||||||
|
static private(set) weak var shared: HPVM?
|
||||||
|
|
||||||
|
init() {
|
||||||
|
Self.shared = self
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../hp/mac/view/HPView.swift
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../hp.swift
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
import SwiftCrossUI
|
||||||
|
|
||||||
|
final class HPVM: ObservableObject {
|
||||||
|
@Published var countText = ""
|
||||||
|
|
||||||
|
static private(set) weak var shared: HPVM?
|
||||||
|
|
||||||
|
init() {
|
||||||
|
Self.shared = self
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,22 @@
|
|||||||
|
import SwiftCrossUI
|
||||||
|
|
||||||
|
struct HPView: View {
|
||||||
|
@State var vm: HPVM
|
||||||
|
|
||||||
|
init(_ vm: HPVM) {
|
||||||
|
self.vm = vm
|
||||||
|
}
|
||||||
|
|
||||||
|
var body: some View {
|
||||||
|
VStack(spacing: 16) {
|
||||||
|
Text("Hello, platform!")
|
||||||
|
.font(.largeTitle)
|
||||||
|
Text(vm.countText)
|
||||||
|
.font(.title3.monospaced())
|
||||||
|
Button("Increment") {
|
||||||
|
hpSet(F.didClickIncrement, true)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
.padding(40)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,22 @@
|
|||||||
|
import SwiftUI
|
||||||
|
|
||||||
|
struct HPView: View {
|
||||||
|
@ObservedObject var vm: HPVM
|
||||||
|
|
||||||
|
init(_ vm: HPVM) {
|
||||||
|
self.vm = vm
|
||||||
|
}
|
||||||
|
|
||||||
|
var body: some View {
|
||||||
|
VStack(spacing: 16) {
|
||||||
|
Text("Hello, platform!")
|
||||||
|
.font(.largeTitle)
|
||||||
|
Text(vm.countText)
|
||||||
|
.font(.title3.monospaced())
|
||||||
|
Button("Increment") {
|
||||||
|
hpSet(F.didClickIncrement, true)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
.padding(40)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,225 @@
|
|||||||
|
# hello-platform
|
||||||
|
|
||||||
|
Minimal macOS, iOS and Android app that validates the platform foundation: a
|
||||||
|
"Hello, platform!" title, a count label and an Increment button. All state lives
|
||||||
|
in Dialect; SwiftUI and Compose only render the view model and send one input
|
||||||
|
event.
|
||||||
|
|
||||||
|
## Layout
|
||||||
|
|
||||||
|
```text
|
||||||
|
hello/hello-platform/
|
||||||
|
├── dialect.yml Dialect v4 source: fields, oneliners, shoulds
|
||||||
|
├── util/
|
||||||
|
│ ├── build-mac generate → build → package
|
||||||
|
│ ├── run-mac run the packaged .app
|
||||||
|
│ ├── prepare-ios generate → xcodegen project
|
||||||
|
│ ├── prepare-android generate Kotlin dialect.kt
|
||||||
|
│ └── step/
|
||||||
|
│ ├── generateDialect sibling ../dialect generator on dialect.yml
|
||||||
|
│ ├── buildMac swift build in ver-mac/
|
||||||
|
│ ├── packageMac ver-mac/.build/hello-platform.app
|
||||||
|
│ ├── runMac launch Contents/MacOS/hello-platform
|
||||||
|
│ └── prepareIOS xcodegen in ver-ios/
|
||||||
|
├── ver-mac/
|
||||||
|
│ ├── Package.swift one executable target, path "src", macOS 13
|
||||||
|
│ ├── Info.plist org.opengamestudio.hello-platform, AppIcon
|
||||||
|
│ ├── res/AppIcon.icns copied into the bundle's Resources
|
||||||
|
│ ├── .build/ SPM output + packaged .app (git-ignored)
|
||||||
|
│ └── src/
|
||||||
|
│ ├── HPApp.swift @main WindowGroup → HPView
|
||||||
|
│ ├── HPAppDelegate.swift builds HPComponent + HPVM, logs, calls setup()
|
||||||
|
│ ├── dialect.swift generated by Dialect, never hand-edited
|
||||||
|
│ ├── hp/ relative symlinks into components/hp
|
||||||
|
│ │ ├── hp.swift
|
||||||
|
│ │ ├── hpVM.swift
|
||||||
|
│ │ └── view/HPView.swift → components/hp/mac/view/HPView.swift
|
||||||
|
│ └── other/other.swift relative symlink into components/other
|
||||||
|
└── ver-ios/
|
||||||
|
├── project.yml xcodegen: target hello-platform, iOS 15
|
||||||
|
├── Info.plist org.opengamestudio.hello-platform
|
||||||
|
├── Assets.xcassets/ AppIcon.appiconset/AppIcon.png → res/AppIcon.png
|
||||||
|
├── hello-platform.xcodeproj generated, git-ignored
|
||||||
|
├── .build/ xcodebuild DerivedData (git-ignored)
|
||||||
|
└── src/
|
||||||
|
├── HPApp.swift @main WindowGroup → HPView
|
||||||
|
├── HPAppDelegate.swift same HPComponent + HPVM + logging as macOS
|
||||||
|
├── dialect.swift symlink → ../../ver-mac/src/dialect.swift
|
||||||
|
├── hp/ same links as ver-mac, except view/HPView.swift
|
||||||
|
│ → components/hp/ios/view/HPView.swift
|
||||||
|
└── other/other.swift same symlink as the macOS tree
|
||||||
|
```
|
||||||
|
|
||||||
|
The Android target mirrors the same layout:
|
||||||
|
|
||||||
|
```text
|
||||||
|
hello/hello-platform/ver-android/
|
||||||
|
├── settings.gradle.kts rootProject "hello-platform", includes app
|
||||||
|
├── app/build.gradle.kts org.opengamestudio.helloplatform, Compose
|
||||||
|
├── gradle/ AGP 8.7.3, Kotlin 2.1.0, wrapper 9.3.1
|
||||||
|
├── local.properties sdk.dir, git-ignored
|
||||||
|
├── build/ Gradle output and APK (git-ignored)
|
||||||
|
└── app/src/main/
|
||||||
|
├── AndroidManifest.xml label hello-platform, Theme.MyApplication
|
||||||
|
├── res/ strings, theme, adaptive launcher icon
|
||||||
|
└── kotlin/org/opengamestudio/
|
||||||
|
├── MainActivity.kt Compose Box → HPView, edge-to-edge
|
||||||
|
├── HPActivityDelegate.kt HPComponent + logging, calls setup()
|
||||||
|
├── dialect.kt generated Kotlin, never hand-edited
|
||||||
|
├── hp/ relative symlinks into components/hp/android
|
||||||
|
│ ├── hp.kt
|
||||||
|
│ ├── hpVM.kt
|
||||||
|
│ └── view/HPView.kt → components/hp/android/view/HPView.kt
|
||||||
|
└── other/other.kt relative symlink into components/other
|
||||||
|
```
|
||||||
|
|
||||||
|
`components/` is the source of truth. The `src/hp` and `src/other` entries are
|
||||||
|
symlinks, so edit the real files under `components/` and keep the links intact.
|
||||||
|
macOS and iOS share one `dialect.swift` (the iOS one is a symlink to `ver-mac`),
|
||||||
|
one `HPView` body (the iOS `components/hp/ios/view/HPView.swift` links back to
|
||||||
|
the macOS view) and one `res/AppIcon.png`. Android has its own generated
|
||||||
|
`dialect.kt` and Compose view, with the same state and layout.
|
||||||
|
|
||||||
|
## Shared components
|
||||||
|
|
||||||
|
- `components/hp/hp.swift` — `HPComponent` owns `DialectController(HPContext)`,
|
||||||
|
registers the generated effects and shoulds, publishes `singleton` and exposes
|
||||||
|
`setup()` (`hpSet(F.didSetup, true)`).
|
||||||
|
- `components/hp/hpVM.swift` — `HPVM` is an `ObservableObject` with
|
||||||
|
`@Published countText` and a weak `shared` instance.
|
||||||
|
- `components/hp/mac/view/HPView.swift` — SwiftUI view observing `HPVM`; the
|
||||||
|
button dispatches `hpSet(F.didClickIncrement, true)`. It is platform-neutral,
|
||||||
|
so `components/hp/ios/view/HPView.swift` is a symlink back to it and both
|
||||||
|
`src/hp/view/HPView.swift` links resolve to the same file.
|
||||||
|
- `components/hp/android/` — the Android mirror: `hp.kt` (same `HPComponent`),
|
||||||
|
`hpVM.kt` (`HPVM` with a Compose `mutableStateOf`) and `view/HPView.kt`
|
||||||
|
(Compose `Column`, headline, monospaced label, Increment button).
|
||||||
|
- `components/other/other.swift` / `other.kt` — helpers, including
|
||||||
|
`otherSetupConsoleLogging(ctrl, "HP")`, which prints every processed field to
|
||||||
|
stderr as `ИГР HP k/v: '<field>'/'<value>'`.
|
||||||
|
|
||||||
|
## Startup flow
|
||||||
|
|
||||||
|
1. `HPAppDelegate` creates `HPComponent` (which sets `HPComponent.singleton`)
|
||||||
|
and then `HPVM` (which sets `HPVM.shared`).
|
||||||
|
2. The launch callback (`applicationDidFinishLaunching` on macOS,
|
||||||
|
`application(_:didFinishLaunchingWithOptions:)` on iOS,
|
||||||
|
`HPActivityDelegate.setup()` in `MainActivity.onCreate` on Android) registers
|
||||||
|
console logging and calls `hp.setup()`; the macOS one also activates the app.
|
||||||
|
3. `setup()` queues `didSetup` in the controller.
|
||||||
|
4. The controller applies the changed field, runs every registered should in
|
||||||
|
order, and queues each new `recentField` a should returns. Finally it reports
|
||||||
|
the context to callbacks: logging plus the `countText` oneliner, which copies
|
||||||
|
`c.countText` into `HPVM.shared`.
|
||||||
|
5. `HPView` re-renders from the published view model.
|
||||||
|
|
||||||
|
## Dialect rules (`dialect.yml`)
|
||||||
|
|
||||||
|
Fields: `count`, `countText`, `didClickIncrement`, `didLaunch`, `didSetup`.
|
||||||
|
Shoulds exist for `count`, `countText` and `didLaunch`; `didClickIncrement` and
|
||||||
|
`didSetup` are pure inputs.
|
||||||
|
|
||||||
|
- `count`:
|
||||||
|
- on `didClickIncrement` when `count == 7` → `count += 10`;
|
||||||
|
- on every `didClickIncrement` → `count += 1`.
|
||||||
|
The first matching rule returns, so the click made while the count is 7 adds
|
||||||
|
10 and jumps to 17.
|
||||||
|
- `countText`:
|
||||||
|
- on `count` → `"Count: '<count>'"`;
|
||||||
|
- on `didLaunch` → `"Press the button to count"`.
|
||||||
|
- `didLaunch`: on `didSetup` while `didLaunch == false` → `true`, once.
|
||||||
|
|
||||||
|
Oneliners: `countText` → `HPVM.shared!.countText = c.countText`.
|
||||||
|
|
||||||
|
## Build and run
|
||||||
|
|
||||||
|
```sh
|
||||||
|
cd hello/hello-platform
|
||||||
|
util/build-mac
|
||||||
|
util/run-mac
|
||||||
|
```
|
||||||
|
|
||||||
|
`generateDialect` expects the sibling `../dialect` checkout (so
|
||||||
|
`/Volumes/MOE/p/dialect` for this workspace). `build-mac` runs the steps in
|
||||||
|
order: regenerate `ver-mac/src/dialect.swift` and the Android `dialect.kt`,
|
||||||
|
`swift build`, then package `ver-mac/.build/debug/hello-platform`, `Info.plist`
|
||||||
|
and `res/` into `ver-mac/.build/hello-platform.app`.
|
||||||
|
|
||||||
|
iOS needs `xcodegen` (see README prerequisites):
|
||||||
|
|
||||||
|
```sh
|
||||||
|
cd hello/hello-platform
|
||||||
|
util/prepare-ios
|
||||||
|
xcodebuild -project ver-ios/hello-platform.xcodeproj \
|
||||||
|
-scheme hello-platform -sdk iphonesimulator \
|
||||||
|
-destination 'generic/platform=iOS Simulator' \
|
||||||
|
CODE_SIGNING_ALLOWED=NO build
|
||||||
|
```
|
||||||
|
|
||||||
|
`prepare-ios` regenerates `dialect.swift` and then runs `xcodegen` in
|
||||||
|
`ver-ios/`. The generated `.xcodeproj` and `.build/` are git-ignored, so
|
||||||
|
re-run it after changing `project.yml` or `Info.plist`.
|
||||||
|
|
||||||
|
Android needs the SDK and a JDK; `prepare-android` writes the Kotlin dialect,
|
||||||
|
then Gradle builds the app:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
cd hello/hello-platform
|
||||||
|
util/prepare-android
|
||||||
|
cd ver-android
|
||||||
|
JAVA_HOME="$HOME/.gradle/jdks/eclipse_adoptium-21-aarch64-os_x.2/jdk-21.0.7+6/Contents/Home" \
|
||||||
|
./gradlew assembleDebug
|
||||||
|
```
|
||||||
|
|
||||||
|
`ver-android/local.properties` points at `~/Library/Android/sdk` and is
|
||||||
|
git-ignored, so each checkout needs it once. Install the APK with
|
||||||
|
`adb install -r app/build/outputs/apk/debug/app-debug.apk` and start
|
||||||
|
`org.opengamestudio.helloplatform/org.opengamestudio.MainActivity`. Use JDK 21:
|
||||||
|
AGP 8.7.3 does not accept every newer JDK.
|
||||||
|
|
||||||
|
## Pitfalls
|
||||||
|
|
||||||
|
- Change `dialect.yml`, not the generated `dialect.swift` / `dialect.kt`;
|
||||||
|
retyping or reformatting them is pointless because every build overwrites
|
||||||
|
them.
|
||||||
|
- The Kotlin output is transpiled through the local LLM, so `ollama serve` must
|
||||||
|
be running (with `qwen2.5-coder:3b` pulled) before `prepare-android` or
|
||||||
|
`build-mac`; otherwise generation aborts and `dialect.kt` is left stale.
|
||||||
|
- Every should label (`1. Upon ...`) must end with a colon: the sibling generator
|
||||||
|
drops its last character (`../dialect/components/yml/ymlFun.swift`).
|
||||||
|
- A should function may change only one field; its returned `recentField` drives
|
||||||
|
the next queue entry.
|
||||||
|
- The generated oneliner and `hpSet` force-unwrap `HPVM.shared` /
|
||||||
|
`HPComponent.singleton`; both must exist before dispatch.
|
||||||
|
- Only one `dialect.swift` exists: `ver-ios/src/dialect.swift` is a symlink to
|
||||||
|
the macOS file, so `prepare-ios` regenerates the same source. The Kotlin
|
||||||
|
`dialect.kt` lives in `ver-android` and is generated from the same
|
||||||
|
`dialect.yml`.
|
||||||
|
|
||||||
|
## Linux launcher icon
|
||||||
|
|
||||||
|
`ver-linux` uses GtkBackend with application ID
|
||||||
|
`org.opengamestudio.hello-platform`. On Linux run
|
||||||
|
`hello/hello-platform/util/build-linux` from the repository root to build and install
|
||||||
|
the executable under `~/.local/bin`, the desktop entry under
|
||||||
|
`${XDG_DATA_HOME:-~/.local/share}/applications`, and the shared 1024px
|
||||||
|
`res/AppIcon.png` under the matching hicolor icon name. The launcher uses an
|
||||||
|
absolute executable path. Launch from the desktop application menu after
|
||||||
|
installation; GTK's application ID matches the desktop and icon names.
|
||||||
|
Desktop-entry installation uses `cp` and GNU `sed -i`; Python is not required.
|
||||||
|
The replacement supports spaces but assumes paths contain no sed replacement
|
||||||
|
metacharacters (`&`, `|`, backslashes) or desktop-entry quoting characters.
|
||||||
|
Requires the normal Swift/GTK build dependencies. Installation is per-user and
|
||||||
|
requires no root privileges.
|
||||||
|
|
||||||
|
The Linux build runs `step/buildLinux` followed by `step/packageLinux`.
|
||||||
|
The shared launcher template is `res/linux-app.desktop`; packaging copies it
|
||||||
|
and substitutes `%APP_NAME%`, `%APP_EXEC%` and `%APP_ID%`.
|
||||||
|
`util/run-linux` uses `gtk-launch org.opengamestudio.hello-platform` to launch
|
||||||
|
the installed desktop entry with its icon association. Run `util/build-linux`
|
||||||
|
first to install/update that entry and executable; `gtk-launch` must be available.
|
||||||
|
`packageLinux` is sourced with the target and display name, like `packageMac`;
|
||||||
|
it installs the executable, launcher and icon for the current user and refreshes
|
||||||
|
the desktop/icon caches. It requires GNU sed, gtk-update-icon-cache and
|
||||||
|
update-desktop-database. The standalone `install-linux` script has been replaced
|
||||||
|
by this packaging step.
|
||||||
@@ -0,0 +1,53 @@
|
|||||||
|
version: 4
|
||||||
|
|
||||||
|
output:
|
||||||
|
ver-android/app/src/main/kotlin/org/opengamestudio/dialect.kt:
|
||||||
|
type: kotlin
|
||||||
|
ver-mac/src/dialect.swift:
|
||||||
|
type: swift
|
||||||
|
|
||||||
|
HPContext:
|
||||||
|
type: context
|
||||||
|
fields:
|
||||||
|
count: Int
|
||||||
|
countText: String
|
||||||
|
didClickIncrement: Bool
|
||||||
|
didLaunch: Bool
|
||||||
|
didSetup: Bool
|
||||||
|
|
||||||
|
HPComponent:
|
||||||
|
type: component
|
||||||
|
oneliners:
|
||||||
|
- countText: HPVM.shared!.countText = c.countText
|
||||||
|
shoulds:
|
||||||
|
count:
|
||||||
|
1. Upon hitting 7:
|
||||||
|
if:
|
||||||
|
c.recentField == F.didClickIncrement &&
|
||||||
|
c.count == 7
|
||||||
|
then:
|
||||||
|
c.count += 10
|
||||||
|
2. Upon each button click:
|
||||||
|
if:
|
||||||
|
c.recentField == F.didClickIncrement
|
||||||
|
then:
|
||||||
|
c.count += 1
|
||||||
|
countText:
|
||||||
|
1. Upon each count change:
|
||||||
|
if:
|
||||||
|
c.recentField == F.count
|
||||||
|
then:
|
||||||
|
c.countText = "Count: '\(c.count)'"
|
||||||
|
2. Upon launch:
|
||||||
|
if:
|
||||||
|
c.recentField == F.didLaunch
|
||||||
|
then:
|
||||||
|
c.countText = "Press the button to count"
|
||||||
|
didLaunch:
|
||||||
|
1. Only once during the first setup:
|
||||||
|
if:
|
||||||
|
c.recentField == F.didSetup &&
|
||||||
|
c.didLaunch == false
|
||||||
|
then:
|
||||||
|
c.didLaunch = true
|
||||||
|
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
SDIR=$(cd "$(dirname "$0")" ; pwd -P)
|
||||||
|
|
||||||
|
T=$SDIR/step
|
||||||
|
TARGET=hello-platform
|
||||||
|
|
||||||
|
STEP=0
|
||||||
|
source $T/buildLinux $TARGET
|
||||||
|
source $T/packageLinux $TARGET hello-platform
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
SDIR=$(cd "$(dirname "$0")" ; pwd -P)
|
||||||
|
|
||||||
|
T=$SDIR/step
|
||||||
|
TARGET=hello-platform
|
||||||
|
|
||||||
|
STEP=0
|
||||||
|
source $T/generateDialect $TARGET
|
||||||
|
source $T/buildMac $TARGET
|
||||||
|
source $T/packageMac $TARGET hello-platform
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
SDIR=$(cd "$(dirname "$0")" ; pwd -P)
|
||||||
|
|
||||||
|
T=$SDIR/step
|
||||||
|
TARGET=hello-platform
|
||||||
|
|
||||||
|
STEP=0
|
||||||
|
source $T/generateDialect $TARGET
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
SDIR=$(cd "$(dirname "$0")" ; pwd -P)
|
||||||
|
|
||||||
|
T=$SDIR/step
|
||||||
|
TARGET=hello-platform
|
||||||
|
|
||||||
|
STEP=0
|
||||||
|
source $T/generateDialect $TARGET
|
||||||
|
source $T/prepareIOS $TARGET
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
SDIR=$(cd "$(dirname "$0")" ; pwd -P)
|
||||||
|
|
||||||
|
T=$SDIR/step
|
||||||
|
|
||||||
|
STEP=0
|
||||||
|
source $T/runLinux hello-platform hello-platform
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
SDIR=$(cd "$(dirname "$0")" ; pwd -P)
|
||||||
|
|
||||||
|
T=$SDIR/step
|
||||||
|
|
||||||
|
STEP=0
|
||||||
|
source $T/runMac hello-platform hello-platform
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
|
||||||
|
TARGET=$1
|
||||||
|
STEP=$((STEP+1))
|
||||||
|
echo -e "\n> > > > Step №$STEP. Build '$TARGET' for Linux"
|
||||||
|
|
||||||
|
cd $SDIR/../ver-linux
|
||||||
|
swift build
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
|
||||||
|
TARGET=$1
|
||||||
|
STEP=$((STEP+1))
|
||||||
|
echo -e "\n> > > > Step №$STEP. Build '$TARGET' for macOS"
|
||||||
|
|
||||||
|
cd $SDIR/../ver-mac
|
||||||
|
swift build
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
|
||||||
|
TARGET=$1
|
||||||
|
STEP=$((STEP+1))
|
||||||
|
echo -e "\n> > > > Step №$STEP. Generate Dialect for '$TARGET'"
|
||||||
|
|
||||||
|
$SDIR/../../../util/run-generator --file=$SDIR/../dialect.yml
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
|
||||||
|
TARGET=$1
|
||||||
|
APP_NAME=$2
|
||||||
|
|
||||||
|
STEP=$((STEP+1))
|
||||||
|
echo -e "\n> > > > Step №$STEP. Make '$APP_NAME' Linux package for '$TARGET'"
|
||||||
|
APP_DIR="$SDIR/../ver-linux"
|
||||||
|
DATA_DIR="${XDG_DATA_HOME:-$HOME/.local/share}"
|
||||||
|
BIN_DIR="$HOME/.local/bin"
|
||||||
|
APP_ID=org.opengamestudio.$TARGET
|
||||||
|
|
||||||
|
mkdir -p "$BIN_DIR" "$DATA_DIR/applications" "$DATA_DIR/icons/hicolor/1024x1024/apps"
|
||||||
|
cp "$APP_DIR/.build/debug/$TARGET" "$BIN_DIR/$TARGET"
|
||||||
|
cp "$SDIR/../../../res/AppIcon.png" \
|
||||||
|
"$DATA_DIR/icons/hicolor/1024x1024/apps/$APP_ID.png"
|
||||||
|
|
||||||
|
# Use an absolute executable path: graphical sessions may omit ~/.local/bin.
|
||||||
|
DESKTOP_FILE="$DATA_DIR/applications/$APP_ID.desktop"
|
||||||
|
cp "$SDIR/../../../res/linux-app.desktop" "$DESKTOP_FILE"
|
||||||
|
sed -i \
|
||||||
|
-e "s|%APP_NAME%|$APP_NAME|g" \
|
||||||
|
-e "s|%APP_EXEC%|$BIN_DIR/$TARGET|g" \
|
||||||
|
-e "s|%APP_ID%|$APP_ID|g" \
|
||||||
|
"$DESKTOP_FILE"
|
||||||
|
|
||||||
|
# Update icon cache for new icon to be visible
|
||||||
|
gtk-update-icon-cache --force --ignore-theme-index "$DATA_DIR/icons/hicolor"
|
||||||
|
update-desktop-database "$DATA_DIR/applications"
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
|
||||||
|
TARGET=$1
|
||||||
|
APP_NAME=$2
|
||||||
|
|
||||||
|
STEP=$((STEP+1))
|
||||||
|
echo -e "\n> > > > Step №$STEP. Make '$APP_NAME' macOS package for '$TARGET'"
|
||||||
|
|
||||||
|
APP_MAC="$SDIR/../ver-mac/.build/$APP_NAME.app"
|
||||||
|
rm -rf "$APP_MAC"
|
||||||
|
|
||||||
|
APP_DAT="$APP_MAC/Contents"
|
||||||
|
mkdir -p "$APP_DAT/MacOS"
|
||||||
|
mkdir -p "$APP_DAT/Resources"
|
||||||
|
cp $SDIR/../ver-mac/.build/debug/$TARGET "$APP_DAT/MacOS/$TARGET"
|
||||||
|
cp $SDIR/../ver-mac/Info.plist "$APP_DAT/Info.plist"
|
||||||
|
# Copy resources with symlink dereferencing
|
||||||
|
cp -R -L $SDIR/../ver-mac/res/* "$APP_DAT/Resources/"
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
|
||||||
|
TARGET=$1
|
||||||
|
STEP=$((STEP+1))
|
||||||
|
echo -e "\n> > > > Step №$STEP. Generate Xcode project for '$TARGET' iOS"
|
||||||
|
|
||||||
|
cd $SDIR/../ver-ios
|
||||||
|
xcodegen
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
|
||||||
|
TARGET=$1
|
||||||
|
APP_NAME=$2
|
||||||
|
STEP=$((STEP+1))
|
||||||
|
echo -e "\n> > > > Step №$STEP. Run Linux app for '$TARGET'"
|
||||||
|
|
||||||
|
gtk-launch "org.opengamestudio.$TARGET"
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
#!/bin/bash -e
|
||||||
|
|
||||||
|
TARGET=$1
|
||||||
|
APP_NAME=$2
|
||||||
|
STEP=$((STEP+1))
|
||||||
|
echo -e "\n> > > > Step №$STEP. Run macOS app for '$TARGET'"
|
||||||
|
|
||||||
|
"$SDIR/../ver-mac/.build/$APP_NAME.app/Contents/MacOS/$TARGET"
|
||||||
@@ -0,0 +1,44 @@
|
|||||||
|
import org.jetbrains.kotlin.gradle.dsl.JvmTarget.*
|
||||||
|
|
||||||
|
plugins {
|
||||||
|
alias(libs.plugins.android.application)
|
||||||
|
alias(libs.plugins.kotlin.android)
|
||||||
|
alias(libs.plugins.kotlin.compose)
|
||||||
|
}
|
||||||
|
|
||||||
|
android {
|
||||||
|
namespace = "org.opengamestudio"
|
||||||
|
compileSdk = 35
|
||||||
|
|
||||||
|
buildFeatures {
|
||||||
|
compose = true
|
||||||
|
}
|
||||||
|
compileOptions {
|
||||||
|
sourceCompatibility = JavaVersion.VERSION_1_8
|
||||||
|
targetCompatibility = JavaVersion.VERSION_1_8
|
||||||
|
}
|
||||||
|
defaultConfig {
|
||||||
|
applicationId = "org.opengamestudio.helloplatform"
|
||||||
|
minSdk = 24
|
||||||
|
targetSdk = 35
|
||||||
|
versionCode = 1
|
||||||
|
versionName = "1.0"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
dependencies {
|
||||||
|
implementation(libs.androidx.activity.compose)
|
||||||
|
implementation(platform(libs.androidx.compose.bom))
|
||||||
|
implementation(libs.androidx.core.ktx)
|
||||||
|
implementation(libs.androidx.lifecycle.runtime.ktx)
|
||||||
|
implementation(libs.androidx.material3)
|
||||||
|
implementation(libs.androidx.ui)
|
||||||
|
implementation(libs.androidx.ui.graphics)
|
||||||
|
implementation(libs.androidx.ui.tooling.preview)
|
||||||
|
}
|
||||||
|
|
||||||
|
kotlin {
|
||||||
|
compilerOptions {
|
||||||
|
jvmTarget = JVM_1_8
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
|
||||||
|
xmlns:tools="http://schemas.android.com/tools">
|
||||||
|
|
||||||
|
<application
|
||||||
|
android:allowBackup="true"
|
||||||
|
android:dataExtractionRules="@xml/data_extraction_rules"
|
||||||
|
android:fullBackupContent="@xml/backup_rules"
|
||||||
|
android:icon="@mipmap/ic_launcher"
|
||||||
|
android:label="@string/app_name"
|
||||||
|
android:roundIcon="@mipmap/ic_launcher_round"
|
||||||
|
android:supportsRtl="true"
|
||||||
|
android:theme="@style/Theme.MyApplication"
|
||||||
|
tools:targetApi="35">
|
||||||
|
<activity
|
||||||
|
android:name=".MainActivity"
|
||||||
|
android:exported="true"
|
||||||
|
android:label="@string/app_name"
|
||||||
|
android:theme="@style/Theme.MyApplication"
|
||||||
|
>
|
||||||
|
<intent-filter>
|
||||||
|
<action android:name="android.intent.action.MAIN" />
|
||||||
|
|
||||||
|
<category android:name="android.intent.category.LAUNCHER" />
|
||||||
|
</intent-filter>
|
||||||
|
</activity>
|
||||||
|
</application>
|
||||||
|
|
||||||
|
</manifest>
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
package org.opengamestudio
|
||||||
|
|
||||||
|
object HPActivityDelegate {
|
||||||
|
val hp = HPComponent
|
||||||
|
|
||||||
|
init {
|
||||||
|
otherSetupConsoleLogging(hp.ctrl, "HP")
|
||||||
|
}
|
||||||
|
|
||||||
|
fun setup() {
|
||||||
|
hp.setup()
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,36 @@
|
|||||||
|
package org.opengamestudio
|
||||||
|
|
||||||
|
import android.graphics.Color
|
||||||
|
import android.os.Bundle
|
||||||
|
import androidx.activity.*
|
||||||
|
import androidx.activity.compose.setContent
|
||||||
|
import androidx.compose.foundation.background
|
||||||
|
import androidx.compose.foundation.layout.*
|
||||||
|
import androidx.compose.ui.*
|
||||||
|
import androidx.compose.ui.graphics.Color as ComposeColor
|
||||||
|
import org.opengamestudio.ui.theme.MyApplicationTheme
|
||||||
|
|
||||||
|
class MainActivity: ComponentActivity() {
|
||||||
|
override fun onCreate(savedInstanceState: Bundle?) {
|
||||||
|
super.onCreate(savedInstanceState)
|
||||||
|
|
||||||
|
HPActivityDelegate.setup()
|
||||||
|
|
||||||
|
enableEdgeToEdge(
|
||||||
|
navigationBarStyle = SystemBarStyle.light(Color.TRANSPARENT, Color.TRANSPARENT),
|
||||||
|
statusBarStyle = SystemBarStyle.light(Color.TRANSPARENT, Color.TRANSPARENT)
|
||||||
|
)
|
||||||
|
setContent {
|
||||||
|
MyApplicationTheme {
|
||||||
|
Box(
|
||||||
|
contentAlignment = Alignment.Center,
|
||||||
|
modifier = Modifier
|
||||||
|
.fillMaxSize()
|
||||||
|
.background(ComposeColor.White)
|
||||||
|
) {
|
||||||
|
HPView()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,284 @@
|
|||||||
|
package org.opengamestudio
|
||||||
|
|
||||||
|
|
||||||
|
val DIALECT_CONTEXT_RECENT_FIELD_NONE = "none"
|
||||||
|
|
||||||
|
interface DialectContext {
|
||||||
|
/**
|
||||||
|
* Name of the field that has just been changed
|
||||||
|
*
|
||||||
|
* Allows should-functions (reducers) to react only to
|
||||||
|
* relevant changes and ignore other changes of DialectContext
|
||||||
|
*/
|
||||||
|
var recentField: String
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get field's value by its name
|
||||||
|
*/
|
||||||
|
fun <T> field(name: String): T
|
||||||
|
/**
|
||||||
|
* Erase type
|
||||||
|
*
|
||||||
|
* Used by DialectController to assign recent field's value
|
||||||
|
*/
|
||||||
|
fun fieldAny(name: String): Any {
|
||||||
|
return field(name)
|
||||||
|
}
|
||||||
|
/**
|
||||||
|
* Create a copy of the DialectContext derivative
|
||||||
|
*
|
||||||
|
* Used by DialectController to treat all derived contexts as DialectContext
|
||||||
|
*/
|
||||||
|
fun selfCopy(): DialectContext
|
||||||
|
/**
|
||||||
|
* Set field's value by its name
|
||||||
|
*/
|
||||||
|
fun setField(name: String, value: Any?)
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
class DialectController(
|
||||||
|
var context: DialectContext
|
||||||
|
) {
|
||||||
|
internal var callbacks = mutableListOf<(c: DialectContext) -> Unit>()
|
||||||
|
internal var functions = mutableListOf<(c: DialectContext) -> DialectContext>()
|
||||||
|
var isProcessingQueue = false
|
||||||
|
internal var queue = mutableListOf<DialectContext>()
|
||||||
|
|
||||||
|
fun executeFunctions() {
|
||||||
|
val c = queue.removeAt(0)
|
||||||
|
// Keep SSOT: Only allow single field change per should-function
|
||||||
|
context.recentField = c.recentField
|
||||||
|
context.setField(c.recentField, c.fieldAny(c.recentField))
|
||||||
|
|
||||||
|
for (f in functions) {
|
||||||
|
val ctx = f(context.selfCopy())
|
||||||
|
if (ctx.recentField != DIALECT_CONTEXT_RECENT_FIELD_NONE) {
|
||||||
|
queue.add(ctx)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
reportContext()
|
||||||
|
}
|
||||||
|
|
||||||
|
fun processQueue() {
|
||||||
|
// Prevent recursion.
|
||||||
|
if (isProcessingQueue) {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
isProcessingQueue = true
|
||||||
|
|
||||||
|
while (queue.size > 0) {
|
||||||
|
executeFunctions()
|
||||||
|
}
|
||||||
|
|
||||||
|
isProcessingQueue = false
|
||||||
|
}
|
||||||
|
|
||||||
|
fun registerCallback(cb: (c: DialectContext) -> Unit) {
|
||||||
|
callbacks.add(cb)
|
||||||
|
}
|
||||||
|
|
||||||
|
fun registerFieldCallback(
|
||||||
|
fieldName: String,
|
||||||
|
cb: (DialectContext) -> Unit
|
||||||
|
) {
|
||||||
|
callbacks.add({ c ->
|
||||||
|
if (c.recentField == fieldName) {
|
||||||
|
cb(c)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
fun registerFunction(f: (DialectContext) -> DialectContext) {
|
||||||
|
functions.add(f)
|
||||||
|
}
|
||||||
|
|
||||||
|
fun reportContext() {
|
||||||
|
for (cb in callbacks) {
|
||||||
|
cb(context)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fun set(fieldName: String, value: Any) {
|
||||||
|
var c = context.selfCopy()
|
||||||
|
c.setField(fieldName, value)
|
||||||
|
c.recentField = fieldName
|
||||||
|
queue.add(c)
|
||||||
|
processQueue()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
// Register several oneliner callbacks to a controller
|
||||||
|
@Suppress("UNCHECKED_CAST")
|
||||||
|
fun registerOneliners(
|
||||||
|
ctrl: DialectController,
|
||||||
|
items: Array<Any>
|
||||||
|
) {
|
||||||
|
val halfCount = items.size / 2
|
||||||
|
for (i in 0..<halfCount) {
|
||||||
|
val field = items[i * 2] as String
|
||||||
|
val callback = items[i * 2 + 1] as (c: DialectContext) -> Unit
|
||||||
|
ctrl.registerFieldCallback(field, callback)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Context field names for static type check
|
||||||
|
object F {
|
||||||
|
const val count = "count"
|
||||||
|
const val countText = "countText"
|
||||||
|
const val didClickIncrement = "didClickIncrement"
|
||||||
|
const val didLaunch = "didLaunch"
|
||||||
|
const val didSetup = "didSetup"
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
@Suppress("UNCHECKED_CAST")
|
||||||
|
data class HPContext(
|
||||||
|
var count: Int = 0,
|
||||||
|
var countText: String = "",
|
||||||
|
var didClickIncrement: Boolean = false,
|
||||||
|
var didLaunch: Boolean = false,
|
||||||
|
var didSetup: Boolean = false,
|
||||||
|
|
||||||
|
override var recentField: String = ""
|
||||||
|
) : DialectContext {
|
||||||
|
override fun <T> field(name: String): T {
|
||||||
|
if (name == "count") {
|
||||||
|
return count as T
|
||||||
|
}
|
||||||
|
else if (name == "countText") {
|
||||||
|
return countText as T
|
||||||
|
}
|
||||||
|
else if (name == "didClickIncrement") {
|
||||||
|
return didClickIncrement as T
|
||||||
|
}
|
||||||
|
else if (name == "didLaunch") {
|
||||||
|
return didLaunch as T
|
||||||
|
}
|
||||||
|
else if (name == "didSetup") {
|
||||||
|
return didSetup as T
|
||||||
|
}
|
||||||
|
|
||||||
|
return "" as T
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun selfCopy(): DialectContext {
|
||||||
|
return this.copy()
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun setField(
|
||||||
|
name: String,
|
||||||
|
value: Any?
|
||||||
|
) {
|
||||||
|
if (name == "count") {
|
||||||
|
count = value as Int
|
||||||
|
}
|
||||||
|
else if (name == "countText") {
|
||||||
|
countText = value as String
|
||||||
|
}
|
||||||
|
else if (name == "didClickIncrement") {
|
||||||
|
didClickIncrement = value as Boolean
|
||||||
|
}
|
||||||
|
else if (name == "didLaunch") {
|
||||||
|
didLaunch = value as Boolean
|
||||||
|
}
|
||||||
|
else if (name == "didSetup") {
|
||||||
|
didSetup = value as Boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fun hpSet(
|
||||||
|
key: String,
|
||||||
|
value: Any
|
||||||
|
) {
|
||||||
|
HPComponent.ctrl.set(key, value)
|
||||||
|
}
|
||||||
|
|
||||||
|
fun hpShouldResetCount(c: HPContext): HPContext {
|
||||||
|
val c = c
|
||||||
|
|
||||||
|
// 1. Upon hitting 7
|
||||||
|
if (
|
||||||
|
c.recentField == F.didClickIncrement &&
|
||||||
|
c.count == 7
|
||||||
|
) {
|
||||||
|
c.count += 10
|
||||||
|
c.recentField = F.count
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
// 2. Upon each button click
|
||||||
|
if (
|
||||||
|
c.recentField == F.didClickIncrement
|
||||||
|
) {
|
||||||
|
c.count += 1
|
||||||
|
c.recentField = F.count
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
c.recentField = DIALECT_CONTEXT_RECENT_FIELD_NONE
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
fun hpShouldResetCountText(c: HPContext): HPContext {
|
||||||
|
val c = c
|
||||||
|
|
||||||
|
// 1. Upon each count change
|
||||||
|
if (
|
||||||
|
c.recentField == F.count
|
||||||
|
) {
|
||||||
|
c.countText = "Count: '${c.count}'"
|
||||||
|
c.recentField = F.countText
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
// 2. Upon launch
|
||||||
|
if (
|
||||||
|
c.recentField == F.didLaunch
|
||||||
|
) {
|
||||||
|
c.countText = "Press the button to count"
|
||||||
|
c.recentField = F.countText
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
c.recentField = DIALECT_CONTEXT_RECENT_FIELD_NONE
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
fun hpShouldResetDidLaunch(c: HPContext): HPContext {
|
||||||
|
val c = c
|
||||||
|
|
||||||
|
// 1. Only once during the first setup
|
||||||
|
if (
|
||||||
|
c.recentField == F.didSetup &&
|
||||||
|
c.didLaunch == false
|
||||||
|
) {
|
||||||
|
c.didLaunch = true
|
||||||
|
c.recentField = F.didLaunch
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
c.recentField = DIALECT_CONTEXT_RECENT_FIELD_NONE
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
fun hpRegisterShoulds(ctrl: DialectController) {
|
||||||
|
listOf(
|
||||||
|
::hpShouldResetCount,
|
||||||
|
::hpShouldResetCountText,
|
||||||
|
::hpShouldResetDidLaunch,
|
||||||
|
|
||||||
|
).forEach { f ->
|
||||||
|
ctrl.registerFunction { c -> f(c as HPContext) }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fun hpRegisterEffects(ctrl: DialectController) {
|
||||||
|
registerOneliners(ctrl, arrayOf(
|
||||||
|
F.countText, { c: HPContext -> HPVM.shared!!.countText = c.countText },
|
||||||
|
|
||||||
|
))
|
||||||
|
}
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../../../../../../components/hp/android/hp.kt
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../../../../../../components/hp/android/hpVM.kt
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../../../../../../../components/hp/android/view/HPView.kt
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../../../../../../components/other/other.kt
|
||||||
|
After Width: | Height: | Size: 158 KiB |
|
After Width: | Height: | Size: 4.4 KiB |
|
After Width: | Height: | Size: 4.4 KiB |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 6.8 KiB |
|
After Width: | Height: | Size: 6.8 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 18 KiB |
|
After Width: | Height: | Size: 18 KiB |
@@ -0,0 +1,4 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<resources>
|
||||||
|
<string name="app_name">hello-platform</string>
|
||||||
|
</resources>
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<resources>
|
||||||
|
<style name="Theme.MyApplication" parent="android:Theme.Material.NoActionBar">
|
||||||
|
<item name="android:windowBackground">#FFFFFF</item>
|
||||||
|
</style>
|
||||||
|
</resources>
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
pluginManagement {
|
||||||
|
repositories {
|
||||||
|
google {
|
||||||
|
content {
|
||||||
|
includeGroupByRegex("com\\.android.*")
|
||||||
|
includeGroupByRegex("com\\.google.*")
|
||||||
|
includeGroupByRegex("androidx.*")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
mavenCentral()
|
||||||
|
gradlePluginPortal()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
dependencyResolutionManagement {
|
||||||
|
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
|
||||||
|
repositories {
|
||||||
|
google()
|
||||||
|
mavenCentral()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
rootProject.name = "hello-platform"
|
||||||
|
include("app")
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../../res/AppIcon.png
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
{
|
||||||
|
"images" : [
|
||||||
|
{
|
||||||
|
"filename" : "AppIcon.png",
|
||||||
|
"idiom" : "universal",
|
||||||
|
"platform" : "ios",
|
||||||
|
"size" : "1024x1024"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"info" : {
|
||||||
|
"author" : "xcode",
|
||||||
|
"version" : 1
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||||
|
<plist version="1.0">
|
||||||
|
<dict>
|
||||||
|
<key>CFBundleName</key>
|
||||||
|
<string>hello-platform</string>
|
||||||
|
<key>CFBundleDisplayName</key>
|
||||||
|
<string>hello-platform</string>
|
||||||
|
<key>CFBundleIdentifier</key>
|
||||||
|
<string>org.opengamestudio.hello-platform</string>
|
||||||
|
<key>CFBundleExecutable</key>
|
||||||
|
<string>hello-platform</string>
|
||||||
|
<key>CFBundlePackageType</key>
|
||||||
|
<string>APPL</string>
|
||||||
|
<key>CFBundleShortVersionString</key>
|
||||||
|
<string>1.0</string>
|
||||||
|
<key>CFBundleVersion</key>
|
||||||
|
<string>1</string>
|
||||||
|
<key>UILaunchScreen</key>
|
||||||
|
<dict/>
|
||||||
|
<key>UISupportedInterfaceOrientations</key>
|
||||||
|
<array>
|
||||||
|
<string>UIInterfaceOrientationLandscapeLeft</string>
|
||||||
|
<string>UIInterfaceOrientationLandscapeRight</string>
|
||||||
|
<string>UIInterfaceOrientationPortrait</string>
|
||||||
|
<string>UIInterfaceOrientationPortraitUpsideDown</string>
|
||||||
|
</array>
|
||||||
|
</dict>
|
||||||
|
</plist>
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
name: hello-platform
|
||||||
|
options:
|
||||||
|
bundleIdPrefix: org.opengamestudio
|
||||||
|
targets:
|
||||||
|
hello-platform:
|
||||||
|
type: application
|
||||||
|
platform: iOS
|
||||||
|
deploymentTarget: "15.0"
|
||||||
|
sources:
|
||||||
|
- path: Assets.xcassets
|
||||||
|
- path: src
|
||||||
|
settings:
|
||||||
|
base:
|
||||||
|
INFOPLIST_FILE: Info.plist
|
||||||
|
PRODUCT_BUNDLE_IDENTIFIER: org.opengamestudio.hello-platform
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
import SwiftUI
|
||||||
|
|
||||||
|
@main
|
||||||
|
struct HPApp: App {
|
||||||
|
@UIApplicationDelegateAdaptor(HPAppDelegate.self) private var appDelegate
|
||||||
|
|
||||||
|
var body: some Scene {
|
||||||
|
WindowGroup {
|
||||||
|
HPView(appDelegate.hpVM)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
import UIKit
|
||||||
|
|
||||||
|
final class HPAppDelegate:
|
||||||
|
NSObject,
|
||||||
|
UIApplicationDelegate
|
||||||
|
{
|
||||||
|
let hp = HPComponent()
|
||||||
|
let hpVM = HPVM()
|
||||||
|
|
||||||
|
func application(
|
||||||
|
_ application: UIApplication,
|
||||||
|
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
|
||||||
|
) -> Bool {
|
||||||
|
otherSetupConsoleLogging(hp.ctrl, "HP")
|
||||||
|
hp.setup()
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../components/hp/hp.swift
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../components/hp/hpVM.swift
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../../components/hp/ios/view/HPView.swift
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../components/other/other.swift
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
// swift-tools-version: 5.10
|
||||||
|
import PackageDescription
|
||||||
|
|
||||||
|
let package = Package(
|
||||||
|
name: "hello-platform",
|
||||||
|
dependencies: [
|
||||||
|
.package(url: "https://github.com/moreSwift/swift-cross-ui", branch: "v0.10.0")
|
||||||
|
],
|
||||||
|
targets: [
|
||||||
|
.executableTarget(
|
||||||
|
name: "hello-platform",
|
||||||
|
dependencies: [
|
||||||
|
.product(name: "GtkBackend", package: "swift-cross-ui"),
|
||||||
|
.product(name: "SwiftCrossUI", package: "swift-cross-ui")
|
||||||
|
],
|
||||||
|
path: "src"
|
||||||
|
)
|
||||||
|
]
|
||||||
|
)
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
import GtkBackend
|
||||||
|
import SwiftCrossUI
|
||||||
|
|
||||||
|
@main
|
||||||
|
struct HPApp: App {
|
||||||
|
var backend: GtkBackend {
|
||||||
|
GtkBackend(appIdentifier: "org.opengamestudio.hello-platform")
|
||||||
|
}
|
||||||
|
let delegate = HPAppDelegate()
|
||||||
|
|
||||||
|
var body: some Scene {
|
||||||
|
WindowGroup("Hello platform") {
|
||||||
|
HPView(delegate.hpVM)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
import SwiftCrossUI
|
||||||
|
|
||||||
|
final class HPAppDelegate {
|
||||||
|
let hp = HPComponent()
|
||||||
|
let hpVM = HPVM()
|
||||||
|
|
||||||
|
init() {
|
||||||
|
otherSetupConsoleLogging(hp.ctrl, "HP")
|
||||||
|
hp.setup()
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../components/hp/linux/hp.swift
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../components/hp/linux/hpVM.swift
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../../components/hp/linux/view/HPView.swift
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../components/other/other.swift
|
||||||
@@ -0,0 +1,26 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||||
|
<plist version="1.0">
|
||||||
|
<dict>
|
||||||
|
<key>CFBundleName</key>
|
||||||
|
<string>hello-platform</string>
|
||||||
|
<key>CFBundleDisplayName</key>
|
||||||
|
<string>hello-platform</string>
|
||||||
|
<key>CFBundleIdentifier</key>
|
||||||
|
<string>org.opengamestudio.hello-platform</string>
|
||||||
|
<key>CFBundleExecutable</key>
|
||||||
|
<string>hello-platform</string>
|
||||||
|
<key>CFBundleIconFile</key>
|
||||||
|
<string>AppIcon</string>
|
||||||
|
<key>CFBundlePackageType</key>
|
||||||
|
<string>APPL</string>
|
||||||
|
<key>CFBundleShortVersionString</key>
|
||||||
|
<string>1.0</string>
|
||||||
|
<key>CFBundleVersion</key>
|
||||||
|
<string>1</string>
|
||||||
|
<key>LSMinimumSystemVersion</key>
|
||||||
|
<string>11.0</string>
|
||||||
|
<key>NSHighResolutionCapable</key>
|
||||||
|
<true/>
|
||||||
|
</dict>
|
||||||
|
</plist>
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
// swift-tools-version: 5.9
|
||||||
|
import PackageDescription
|
||||||
|
|
||||||
|
let package = Package(
|
||||||
|
name: "hello-platform",
|
||||||
|
platforms: [
|
||||||
|
.macOS(.v13)
|
||||||
|
],
|
||||||
|
targets: [
|
||||||
|
.executableTarget(
|
||||||
|
name: "hello-platform",
|
||||||
|
path: "src"
|
||||||
|
)
|
||||||
|
]
|
||||||
|
)
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../res/AppIcon.icns
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
import AppKit
|
||||||
|
import SwiftUI
|
||||||
|
|
||||||
|
@main
|
||||||
|
struct HPApp: App {
|
||||||
|
@NSApplicationDelegateAdaptor(HPAppDelegate.self) private var appDelegate
|
||||||
|
|
||||||
|
var body: some Scene {
|
||||||
|
WindowGroup {
|
||||||
|
HPView(appDelegate.hpVM)
|
||||||
|
}
|
||||||
|
.defaultSize(width: 640, height: 480)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,22 @@
|
|||||||
|
import AppKit
|
||||||
|
|
||||||
|
final class HPAppDelegate:
|
||||||
|
NSObject,
|
||||||
|
NSApplicationDelegate
|
||||||
|
{
|
||||||
|
let hp = HPComponent()
|
||||||
|
let hpVM = HPVM()
|
||||||
|
|
||||||
|
func applicationDidFinishLaunching(_ notification: Notification) {
|
||||||
|
// Bring the app to the foreground
|
||||||
|
NSApp.setActivationPolicy(.regular)
|
||||||
|
NSApp.activate(ignoringOtherApps: true)
|
||||||
|
|
||||||
|
otherSetupConsoleLogging(hp.ctrl, "HP")
|
||||||
|
hp.setup()
|
||||||
|
}
|
||||||
|
|
||||||
|
func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool {
|
||||||
|
true
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,275 @@
|
|||||||
|
|
||||||
|
// Reusable "none" constant
|
||||||
|
public let DIALECT_CONTEXT_RECENT_FIELD_NONE = "none"
|
||||||
|
|
||||||
|
// Base protocol for each component's state
|
||||||
|
public protocol DialectContext {
|
||||||
|
var recentField: String { get set }
|
||||||
|
|
||||||
|
func field<T>(_ name: String) -> T
|
||||||
|
func fieldAny(_ name: String) -> Any
|
||||||
|
mutating func setField(_ name: String, _ value: Any)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Default implementation of `fieldAny` method for the protocol
|
||||||
|
public extension DialectContext {
|
||||||
|
func fieldAny(_ name: String) -> Any {
|
||||||
|
return field(name)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// The engine of the dialect components
|
||||||
|
public class DialectController {
|
||||||
|
var callbacks = [(DialectContext) -> Void]()
|
||||||
|
var context: DialectContext
|
||||||
|
var functions = [(DialectContext) -> DialectContext]()
|
||||||
|
var isProcessingQueue = false
|
||||||
|
var queue = [DialectContext]()
|
||||||
|
|
||||||
|
public init(_ context: DialectContext) {
|
||||||
|
self.context = context
|
||||||
|
}
|
||||||
|
|
||||||
|
func executeFunctions() {
|
||||||
|
let c = queue.removeFirst()
|
||||||
|
// Keep SSOT: Only allow single field change per should-function
|
||||||
|
context.recentField = c.recentField
|
||||||
|
context.setField(c.recentField, c.fieldAny(c.recentField))
|
||||||
|
|
||||||
|
for f in functions {
|
||||||
|
let ctx = f(context)
|
||||||
|
if ctx.recentField != DIALECT_CONTEXT_RECENT_FIELD_NONE {
|
||||||
|
queue.append(ctx)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
reportContext()
|
||||||
|
}
|
||||||
|
|
||||||
|
func processQueue() {
|
||||||
|
// Prevent recursion.
|
||||||
|
if isProcessingQueue {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
isProcessingQueue = true
|
||||||
|
|
||||||
|
while (queue.count > 0) {
|
||||||
|
executeFunctions()
|
||||||
|
}
|
||||||
|
|
||||||
|
isProcessingQueue = false
|
||||||
|
}
|
||||||
|
|
||||||
|
public func registerCallback(_ cb: @escaping (DialectContext) -> Void) {
|
||||||
|
callbacks.append(cb)
|
||||||
|
}
|
||||||
|
|
||||||
|
public func registerFieldCallback(
|
||||||
|
_ fieldName: String,
|
||||||
|
_ cb: @escaping (DialectContext) -> Void
|
||||||
|
) {
|
||||||
|
callbacks.append({ c in
|
||||||
|
if c.recentField == fieldName {
|
||||||
|
cb(c)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
public func registerFunction(_ f: @escaping (DialectContext) -> DialectContext) {
|
||||||
|
functions.append(f)
|
||||||
|
}
|
||||||
|
|
||||||
|
func reportContext() {
|
||||||
|
for cb in callbacks {
|
||||||
|
cb(context)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public func set(
|
||||||
|
_ fieldName: String,
|
||||||
|
_ value: Any
|
||||||
|
) {
|
||||||
|
var c = context
|
||||||
|
c.setField(fieldName, value)
|
||||||
|
c.recentField = fieldName
|
||||||
|
queue.append(c)
|
||||||
|
processQueue()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Register several oneliner callbacks to a controller
|
||||||
|
func registerOneliners<T>(
|
||||||
|
_ ctrl: DialectController,
|
||||||
|
_ items: [Any]
|
||||||
|
) -> T? {
|
||||||
|
let halfCount = items.count / 2
|
||||||
|
for i in 0..<halfCount {
|
||||||
|
let field = items[i * 2] as! String
|
||||||
|
let callback = items[i * 2 + 1] as! (T) -> Void
|
||||||
|
ctrl.registerFieldCallback(field) { cc in
|
||||||
|
let c = cc as! T
|
||||||
|
callback(c)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// A hack for generics to operate
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// Context field names for static type check
|
||||||
|
public struct F {
|
||||||
|
public static let count = "count"
|
||||||
|
public static let countText = "countText"
|
||||||
|
public static let didClickIncrement = "didClickIncrement"
|
||||||
|
public static let didLaunch = "didLaunch"
|
||||||
|
public static let didSetup = "didSetup"
|
||||||
|
|
||||||
|
}
|
||||||
|
public struct HPContext: DialectContext {
|
||||||
|
public var count = Int()
|
||||||
|
public var countText = String()
|
||||||
|
public var didClickIncrement = Bool()
|
||||||
|
public var didLaunch = Bool()
|
||||||
|
public var didSetup = Bool()
|
||||||
|
|
||||||
|
public var recentField = ""
|
||||||
|
|
||||||
|
public func field<T>(_ name: String) -> T {
|
||||||
|
if (name == "count") {
|
||||||
|
return count as! T
|
||||||
|
}
|
||||||
|
else if (name == "countText") {
|
||||||
|
return countText as! T
|
||||||
|
}
|
||||||
|
else if (name == "didClickIncrement") {
|
||||||
|
return didClickIncrement as! T
|
||||||
|
}
|
||||||
|
else if (name == "didLaunch") {
|
||||||
|
return didLaunch as! T
|
||||||
|
}
|
||||||
|
else if (name == "didSetup") {
|
||||||
|
return didSetup as! T
|
||||||
|
}
|
||||||
|
|
||||||
|
return "unknown-field-name" as! T
|
||||||
|
}
|
||||||
|
|
||||||
|
public mutating func setField(
|
||||||
|
_ name: String,
|
||||||
|
_ value: Any
|
||||||
|
) {
|
||||||
|
if (name == "count") {
|
||||||
|
count = value as! Int
|
||||||
|
}
|
||||||
|
else if (name == "countText") {
|
||||||
|
countText = value as! String
|
||||||
|
}
|
||||||
|
else if (name == "didClickIncrement") {
|
||||||
|
didClickIncrement = value as! Bool
|
||||||
|
}
|
||||||
|
else if (name == "didLaunch") {
|
||||||
|
didLaunch = value as! Bool
|
||||||
|
}
|
||||||
|
else if (name == "didSetup") {
|
||||||
|
didSetup = value as! Bool
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public func hpSet(
|
||||||
|
_ key: String,
|
||||||
|
_ value: Any
|
||||||
|
) {
|
||||||
|
HPComponent.singleton!.ctrl.set(key, value)
|
||||||
|
}
|
||||||
|
|
||||||
|
func hpShouldResetCount(_ c: HPContext) -> HPContext {
|
||||||
|
var c = c
|
||||||
|
|
||||||
|
/* 1. Upon hitting 7 */
|
||||||
|
if
|
||||||
|
c.recentField == F.didClickIncrement &&
|
||||||
|
c.count == 7
|
||||||
|
{
|
||||||
|
c.count += 10
|
||||||
|
c.recentField = F.count
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 2. Upon each button click */
|
||||||
|
if
|
||||||
|
c.recentField == F.didClickIncrement
|
||||||
|
{
|
||||||
|
c.count += 1
|
||||||
|
c.recentField = F.count
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
c.recentField = DIALECT_CONTEXT_RECENT_FIELD_NONE
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
func hpShouldResetCountText(_ c: HPContext) -> HPContext {
|
||||||
|
var c = c
|
||||||
|
|
||||||
|
/* 1. Upon each count change */
|
||||||
|
if
|
||||||
|
c.recentField == F.count
|
||||||
|
{
|
||||||
|
c.countText = "Count: '\(c.count)'"
|
||||||
|
c.recentField = F.countText
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
/* 2. Upon launch */
|
||||||
|
if
|
||||||
|
c.recentField == F.didLaunch
|
||||||
|
{
|
||||||
|
c.countText = "Press the button to count"
|
||||||
|
c.recentField = F.countText
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
c.recentField = DIALECT_CONTEXT_RECENT_FIELD_NONE
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
func hpShouldResetDidLaunch(_ c: HPContext) -> HPContext {
|
||||||
|
var c = c
|
||||||
|
|
||||||
|
/* 1. Only once during the first setup */
|
||||||
|
if
|
||||||
|
c.recentField == F.didSetup &&
|
||||||
|
c.didLaunch == false
|
||||||
|
{
|
||||||
|
c.didLaunch = true
|
||||||
|
c.recentField = F.didLaunch
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
c.recentField = DIALECT_CONTEXT_RECENT_FIELD_NONE
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
func hpRegisterShoulds(_ ctrl: DialectController) {
|
||||||
|
[
|
||||||
|
hpShouldResetCount,
|
||||||
|
hpShouldResetCountText,
|
||||||
|
hpShouldResetDidLaunch,
|
||||||
|
|
||||||
|
].forEach { f in
|
||||||
|
ctrl.registerFunction { c in f(c as! HPContext) }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func hpRegisterEffects(_ ctrl: DialectController) {
|
||||||
|
let _: HPContext? = registerOneliners(ctrl, [
|
||||||
|
F.countText, { (c: HPContext) in HPVM.shared!.countText = c.countText },
|
||||||
|
|
||||||
|
])
|
||||||
|
}
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../components/hp/hp.swift
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../components/hp/hpVM.swift
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../../components/hp/mac/view/HPView.swift
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
../../../../../components/other/other.swift
|
||||||