Skip to content

ImKit 3.3.0 — Make progress clear

Choose a tag to compare

@AokiMotohide AokiMotohide released this 23 Oct 07:38
8a649d8

ImKit 3.3.0 — Make progress clear

Show how far a task has progressed, which stage is active and what the user can do next, while your application continues to own the work.

Native Gallery: task progress and stages

What is new

  • Shared progress tracks: ProgressTrack / ProgressTrackView show determinate or indeterminate values, labels and supplemental text with Queued, Running, Paused, Succeeded, Failed and Cancelled states.
  • Stages at a glance: StageProgress shows completed, current and queued stages, switching to the current stage and count at narrow widths.
  • Task cards with operations: TaskProgressCard combines title, stage, progress and buttons. It returns a command ID; the application performs the operation and supplies the next state.
  • Richer loading toasts: update the same ToastView with stage, progressText and status, then move it to a success/error message when the work finishes.

Examples and exact API · Public manual.

Compatibility

ToastView appends fields and changes its layout. Recompile your application and linked ImKit static libraries with matching 3.3 headers. Do not mix 3.2 objects and 3.3 structures. Existing function arguments/defaults and dependencies remain unchanged. Dear ImGui remains pinned to docking commit 367b2c24f399988ddafc0bb4628da0106bcc09be (1.93.0 WIP, version number 19297); matching configuration is required. Your application owns context, backends, renderer, fonts, textures, state, workers and persistence.

Downloads

Verification and limits

The release source is 8a649d84c8d9997788596e7bf76d06e4e906b30f, merged through PR #13. All five main CI configurations passed build, test, package and packaged SDK consumer verification. The assembly also checked each SDK consumer source commit, public headers, license files, bilingual 3.3 guides and capture against the release source. Pages CI passed.

Local Windows x64 Debug Workflow/Workflow API/Toast/Toast API regressions passed (4/4). Native OpenGL checks cover toast mouse action/dismiss, keyboard Space, same-ID loading completion, six positions in light/dark and Japanese indeterminate progress. The new GIF records 80 native frames and six public-IO clicks advancing the host-owned task to completion: 960×540, 10 fps, 8 seconds. The existing 3.2 film is labeled historical; it is not 3.3 validation evidence. Documentation pairs/local links and Pages generation/type checking/static build/link checks passed.

Universal 2 tests execute on arm64; Intel executes in a separate job. macOS archives are unsigned and not notarized: signing credentials were unavailable and the CI signing steps were skipped. Physical OS input, native IME, real screen readers, mixed-DPI/multi-monitor, external-host and hardware acceptance have not been performed.

日本語

処理がどこまで進み、今どの工程にいるか、次に何を操作できるかを表示するリリースです。

共通のProgressTrack、工程を並べるStageProgress、操作ボタンを持つTaskProgressCardを追加しました。トーストにも工程・進捗テキスト・処理状態を表示できます。部品は表示と操作要求を受け持ち、処理の実行と状態管理はアプリ側に残します。

コード例と公開API · 日本語マニュアル。上のGIFは3.3のnative Galleryを公開IOで操作して撮影したものです。既存の3.2紹介動画は、旧版の紹介と明記して残しています。

互換性

ToastViewの構造体レイアウトが変わるため、ホストとリンクするImKit静的ライブラリを同じ3.3ヘッダーで再コンパイルしてください。3.2のobjectと3.3の構造体は混在させないでください。 既存関数の引数・既定値、依存、Dear ImGuiの固定revisionと設定一致の要件は維持しています。Context・描画・font・texture・状態・worker・保存の管理も引き続きアプリ側が行います。

配布と検証

上のDownloadsに5構成のSDK、ソース、検証ZIP、manifest、チェックサムを掲載しています。実際のCIとソースコミット、SDK consumerの結果、native検証ファイルのハッシュはmanifestと検証ZIPに記録します。

ローカルの直接回帰4件、nativeトースト操作・Space操作・同じIDでの完了・6配置の明暗・日本語の未確定進捗を確認しました。新しいGIFでは6回のクリック後のホスト値1.0を検査し、実行中と完了の画面を確認しています。日英文書とPagesの生成・型チェック・静的build・リンク検査も成功しました。

Universal 2はarm64で実行し、Intelは別jobです。macOS署名・notarizationは資格情報がなく、CIの該当stepはスキップされています。物理OS入力、native IME、実screen reader、複数モニターDPI、外部ホスト・実機受入は未実施です。