[English] | [日本語]

UIKitとSwiftUIの両方をサポートするJSON駆動のiOS UIフレームワーク。 シンプルなJSON定義と自動コード生成でネイティブiOSインターフェースを構築します。

• 🏗️ セクションベースアーキテクチャ: SwiftUI 向けに CollectionDataSource を再設計
• 📊 柔軟なレイアウト: セクションごとに異なるカラム数とセルタイプ
• 🔄 完全モードサポート: Dynamic と Static モードが同じように動作
• ↔️ スクロールオプション: インジケーター制御付き水平/垂直

7.1.2 リリースノート

• 🔄 バインディングプロパティ: @propertyName 構文で双方向バインディング
• 📝 JSON バインディング: @{propertyName} で ViewModel にバインド

7.1.1 リリースノート

• 🎯 SwiftUI カスタムコンポーネント: sjui g converter がカスタムコンポーネントを生成
• 📁 3つのファイル生成: Swift コンポーネント、Ruby コンバーター、Dynamic アダプター
• 🔥 ホットリロードサポート: カスタムコンポーネントがホットリロードで動作

7.1.0 リリースノート

JSONで一度書けば、UIKitとSwiftUIの両方にデプロイ：

• 統一JSONフォーマット - 単一の定義で両プラットフォームに対応
• 自動MVVM生成 - SwiftUI用のViewModelとデータモデルを自動作成
• スマートモード切り替え - ViewSwitcherがDebug/Releaseビルドを自動最適化
• 完全な機能パリティ - すべてのコンポーネントが両プラットフォームでシームレスに動作

• 明確な構造 - uikitとswiftuiフォルダで実装を明確に分離
• 強化されたCLIツール - sjui_toolsがbinding_builderを置き換え、機能を拡張
• パフォーマンス向上 - 開発用のDynamicモード、本番用のStaticモード

• iOS 16.0+
• Swift 5.8+
• Xcode 14.0+
• Node.js（開発ツール用）

Package.swiftに追加：

dependencies: [
    .package(url: "https://github.com/Tai-Kimura/SwiftJsonUI.git", from: "7.1.2")
]

# ワンラインインストーラー（推奨）
curl -fsSL https://raw.githubusercontent.com/Tai-Kimura/SwiftJsonUI/master/installer/bootstrap.sh | bash

# または特定バージョンをインストール
curl -fsSL https://raw.githubusercontent.com/Tai-Kimura/SwiftJsonUI/master/installer/bootstrap.sh | bash -s -- -v 7.0.0

cd sjui_tools

# プラットフォームを選択
sjui_tools/bin/sjui init --mode uikit     # UIKitのみ
sjui_tools/bin/sjui init --mode swiftui   # SwiftUIのみ
sjui_tools/bin/sjui init --mode all       # 両プラットフォーム

# プロジェクト構造をセットアップ
sjui_tools/bin/sjui setup

SwiftUIの場合：

sjui_tools/bin/sjui g view HomeView --root

以下が生成されます：

• View/HomeView/HomeViewView.swift - 編集可能なビュー
• View/HomeView/HomeViewGeneratedView.swift - 自動生成されるビュー
• ViewModel/HomeViewViewModel.swift - ビジネスロジックを含むViewModel
• Data/HomeViewData.swift - データモデル
• Layouts/home_view.json - JSONレイアウト定義

UIKitの場合：

sjui_tools/bin/sjui g view Home --root

以下が生成されます：

• View/Home/HomeViewController.swift - ビューコントローラー
• Layouts/home.json - JSONレイアウト
• Bindings/HomeBinding.swift - 生成されるバインディング（ビルド後）

Layouts/home_view.jsonを編集：

{
  "type": "SafeAreaView",
  "id": "main_container",
  "background": "#FFFFFF",
  "child": [
    {
      "type": "Label",
      "id": "welcome_text",
      "text": "SwiftJsonUI 7.0へようこそ！",
      "fontSize": 24,
      "fontColor": "#000000",
      "textAlign": "Center"
    },
    {
      "type": "Button",
      "id": "get_started",
      "text": "はじめる",
      "onClick": "handleGetStarted",
      "background": "#007AFF",
      "fontColor": "#FFFFFF",
      "cornerRadius": 8,
      "padding": [12, 24]
    }
  ]
}

# バインディング/ビューを生成
sjui_tools/bin/sjui build

# ホットリロードを開始して即座に更新
sjui_tools/bin/sjui hotload listen

YourApp/
├── Layouts/                      # JSON定義
├── View/                         # SwiftUIビュー
│   └── HomeView/
│       ├── HomeViewView.swift          # 編集可能
│       └── HomeViewGeneratedView.swift # 自動生成
├── ViewModel/                    # ViewModels
└── Data/                         # データモデル

YourApp/
├── Layouts/                      # JSON定義
├── View/                         # ViewControllers
├── Bindings/                     # 生成されたバインディング
└── Core/                         # 基底クラス

再コンパイルせずに変更を即座に確認：

# サーバーを起動
sjui_tools/bin/sjui hotload listen

# JSONファイルを編集 - 変更が即座に反映
# UIKitとSwiftUIの両方で動作

すべてのコンポーネントが両プラットフォームで動作：

{
  "type": "View",
  "id": "my_view",
  "width": "matchParent",
  "height": "wrapContent",
  "child": [...]
}

{
  "data": [
    {
      "name": "userName",
      "class": "String",
      "defaultValue": "ゲスト"
    }
  ],
  "child": [
    {
      "type": "Label",
      "text": "@{userName}"  // 自動バインディング
    }
  ]
}

Styles/に再利用可能なスタイルを作成：

{
  "background": "#007AFF",
  "fontColor": "#FFFFFF",
  "cornerRadius": 8,
  "padding": 12
}

レイアウトで使用：

{
  "type": "Button",
  "style": "primary_button",
  "text": "クリック"
}

# プロジェクトセットアップ
sjui init [--mode uikit|swiftui|all]  # プロジェクト初期化
sjui setup                             # 構造作成

# ビュー生成
sjui g view <名前> [--root]           # ビューを生成
sjui g collection <View>/<Cell>       # コレクションセルを生成
sjui g partial <名前>                 # 再利用可能なパーシャルを生成
sjui g converter <名前> [options]     # カスタムコンポーネントを生成
sjui d view <名前>                    # ビューを削除

# ビルド
sjui build [--mode uikit|swiftui|all] # コード生成
sjui build --clean                     # キャッシュをクリアして再ビルド

# ホットリロード
sjui hotload listen                   # サーバー起動
sjui hotload stop                     # サーバー停止

# ユーティリティ
sjui convert to-group [--force]       # Xcode 16互換性

ビルド設定に基づく自動最適化：

• DEBUG: Dynamicモード - 高速開発のためランタイムでJSONを読み込み
• RELEASE: Staticモード - 最適なパフォーマンスのため生成コードを使用

// 生成コードで自動化
ViewSwitcher(
    isDynamicMode: isDynamicMode,
    dynamicView: { DynamicComponent(...) },
    staticView: { YourGeneratedView(...) }
)

{
  "include": "header",
  "variables": {
    "title": "ようこそ、@{userName}"
  }
}

{
  "type": "Button",
  "onClick": "handleTap",        // メソッドバインディング
  "onLongPress": {
    "closure": "handleLongPress",
    "duration": 0.5
  }
}

# UITableView/UICollectionView用のコレクションセルを生成
sjui g collection ProductList/ProductCell

# 以下が作成されます：
# - View/ProductList/Collection/ProductCell.swift
# - Layouts/product_cell.json

# 再利用可能なパーシャルコンポーネントを生成
sjui g partial header

# レイアウトでの使用方法：
{
  "include": "header"
}

パーシャルとincludeの詳細についてはInclude-Systemを参照してください。

すべてのコンポーネントのデフォルト値をカスタマイズ：

class UIViewCreator: SJUIViewCreator {
    class func prepare() {
        defaultFont = "System"
        defaultFontSize = 14.0
        defaultFontColor = UIColor.label
        // カスタマイズを追加
    }
}

sjui.config.json：

{
  "project_name": "YourApp",
  "mode": "swiftui",  // または "uikit" または "all"
  "layouts_directory_name": "Layouts",
  "styles_directory_name": "Styles"
}

• All-Attributes - すべてのコンポーネントの完全な属性リファレンス
• View Types-ja - 利用可能なコンポーネントタイプ
• Attributes-ja - コア属性システム

• Data-Binding - データバインディングシステム、式、バインディンググループ
• Include-System - コンポーネントの合成と再利用性
• Advanced-Features - イベント処理、ジェスチャー、シャドウなど
• Converter-Command-ja - カスタムSwiftUIコンポーネントの生成

• VSCode-Extension-ja - 自動補完とテンプレート付き公式VSCode拡張機能
• External-Libraries-Integration-ja - サードパーティライブラリの統合

• SwiftJsonUI-7.1.2-Release-Notes-ja - 最新のリリースノート
• SwiftJsonUI-7.1.1-Release-Notes-ja - バインディングプロパティリリース
• SwiftJsonUI-7.1.0-Release-Notes-ja - カスタムコンポーネントリリース
• SwiftJsonUI-7.0.0-Changes - 7.0の詳細な変更ログ
• コンポーネントドキュメント - Label、Button、TextFieldなど

SwiftJsonUIセットアップを示す完全なデモプロジェクト：

git clone https://github.com/Tai-Kimura/bindingTestApp.git
cd bindingTestApp
./bindingTestApp/clear_and_setup.sh

1. Package.swiftをバージョン7.0.0に更新
2. binding_builder参照をsjui_toolsに変更
3. bindingフォルダ参照をuikitに更新
4. 最新バージョンでCLIツールを再インストール
5. sjui init --modeでプラットフォームモードを選択

1. プラットフォームを選択 - UIKitかSwiftUIのいずれかで開始し、必要に応じて後で他方を追加
2. ホットリロードを使用 - UI開発を劇的に高速化
3. サブディレクトリで整理 - 機能ごとに関連レイアウトをグループ化
4. 再利用可能なスタイルを作成 - 一度定義してどこでも使用
5. データバインディングを活用 - 自動更新のため@{}構文を使用

コマンドが見つからない：

# sjui_toolsディレクトリにいることを確認
cd sjui_tools
# 実行可能にする
chmod +x bin/sjui

ホットリロードが動作しない：

# Node.jsインストールを確認
node --version
# サーバーを再起動
sjui hotload stop && sjui hotload listen

ビルドエラー：

# クリーンして再ビルド
sjui build --clean
# JSON構文をチェック
sjui validate

• Issues: GitHub Issues
• Wiki: ドキュメント
• サンプル: サンプルプロジェクト

SwiftJsonUIはMITライセンスで利用可能です。