4D専用に構築された、すぐに使えるPDFジェネレータ、SVGライブラリ、あるいはPPTジェネレータを、ほんの数秒で見つけ、ワンクリックでプロジェクトに追加できると想像してみてください。一から作り直す必要も、同じことを繰り返す必要もありません。
4D Cornerはまさにそれを実現します。これは4Dコンポーネントの公式カタログであり、あらかじめ構築された、コミュニティから提供されたビルディングブロックを閲覧・評価し、わずか数回のクリックで4Dプロジェクトに組み込むことができます。 開発のスピードアップ、アプリの機能拡張、あるいは自身の作品をコミュニティと共有したい場合でも、4D Cornerこそがそのすべてを実現する場です。
このガイドでは、カタログからコンポーネントを見つけて使用する方法、そして準備が整った場合は、ご自身のコンポーネントを寄稿する方法について解説します。
4D Corner とは?
4D Cornerは、開発者があらかじめ構築された4Dコンポーネントを発見、閲覧、統合できる公式リポジトリです。これは、コミュニティから提供された何百ものコンポーネントを一元管理するために設計された厳選されたカタログであり、必要なものを簡単に見つけ、単一の依存関係リンクでプロジェクトにシームレスに追加することができます。
4Dコンポーネントの閲覧と使用
適切なコンポーネントの探し方
- 4D Cornerにアクセス– 利用可能なコンポーネントの完全なカタログを閲覧する
- カテゴリ別検索– 機能、作成者、タグでコンポーネントを絞り込む

- コンポーネントの詳細を表示– 説明、ドキュメント、バージョン情報を確認
- 互換性の確認– プロジェクトに必要な4Dの最低バージョンを確認

- コンポーネントの詳細にアクセス– 任意のコンポーネントをクリックして、詳細情報や統合オプションを確認

プロジェクトへのコンポーネントの追加
使用したいコンポーネントが見つかったら:
- 依存関係リンクをコピーする– 各コンポーネントには、すぐに使用できる依存関係リファレンスが表示されます。「
」をクリックしてください - プロジェクトの依存関係に貼り付ける– 依存関係リンクをプロジェクトの依存関係に直接追加します
- 完了!– これでコンポーネントが統合され、使用可能な状態になりました
得られるもの
4D Cornerのコンポーネントをプロジェクトに追加すると、以下の機能を利用できるようになります:
- あらかじめ構築された機能– 一からコーディングする必要はありません
- 積極的なメンテナンス– コンポーネントは作成者によって定期的に更新されます
- コミュニティによるサポート– 同じコンポーネントを使用している他の開発者と交流できます
- シームレスな統合– コンポーネントは4Dとスムーズに連携するよう設計されています
独自のコンポーネントの共有(オプション)
コンポーネントの公開:技術的な基礎
公開前のチェックリスト
コンポーネントを4D Cornerに掲載する前に、以下の要件がすべて満たされていることを確認してください:
- コンポーネントに有効なアイコン(logo.svg または logo.png)が含まれていること
- GitHub に明確な説明が記載されていること
- リポジトリに「4d-component」トピックが追加されていること
- リポジトリにライセンスが定義されていること
- README ファイルにコンポーネントの使用方法が記載されていること
- コンポーネントが ZIP ファイルとしてパッケージ化され、GitHub リリースに追加されている
- セマンティックバージョニングが採用されています(majorVersion.minorVersion.patchNumber)
JSONマニフェストの構造
4D Cornerにコンポーネントを提出するには、JSONマニフェストファイルを作成する必要があります。このファイルには、4D Cornerがコンポーネントをカタログ化および表示するために使用するメタデータが含まれています。マニフェストは、提出に必須の要素です。
必須項目:
| フィールド | 型 | 説明 |
|---|---|---|
| title | 文字列 | コンポーネントの名前(空にしてはならない) |
| リポジトリ | 文字列 (URL) | コンポーネントの GitHub リポジトリの URL |
オプションのフィールド:
| フィールド | 型 | 説明 |
|---|---|---|
| path_logo | 文字列 (URL) | ロゴファイルへの直接URL。ロゴが標準以外の場所に保存されている場合に便利です |
JSONの例:
{
"title": "4D QPDF",
"repository": "https://github.com/4d/4D-QPDF",
"path_logo": "https://raw.githubusercontent.com/4d/4D-QPDF/main/4D-QPDF/Resources/logo.svg"
}
4D Cornerへのコンポーネントの提出
コンポーネントの準備が整い、JSONマニフェストが完成したら、審査のために4D_Corner_Component_ListGitHubリポジトリにコンポーネントを提出できます:
提出手順:
- プルリクエストの作成–4D_Corner_Component_Listリポジトリに対してプルリクエストを送信し、JSON マニフェストファイルを提出してください
- 4D Cornerチームによる審査– 提出された内容は、品質基準およびガイドラインを満たしているかを確認するため、4D Cornerチームによって審査されます
- 統合– コンポーネントが承認されると、4D Cornerのカタログに統合され、世界中の開発者が検索できるようになります
4D Cornerがリポジトリから抽出する情報
コンポーネントがインデックス登録されると、4D CornerはGitHubリポジトリから自動的にメタデータを抽出します:
| フィールド | ソース | 備考 |
|---|---|---|
| タイトル | リポジトリ名 | カタログで目立つように表示 |
| 著者 | リポジトリ所有者 | コンポーネントの保守担当者を表示します |
| 説明 | リポジトリの説明 | 検索結果および詳細ページに表示されます |
| ライセンス | /license.md ファイル(ルート) | 利用権限についてユーザーに通知します |
| ロゴ | /resources/logo.svg または /resources/logo.png | カタログ内の視覚的識別子 |
| タグ | リポジトリのトピック | ユーザーのフィルタリングや検索を支援 |
| 必要な4Dのバージョン | 最新リリースタグ | 互換性を確保 |
| バージョン | 最新リリースタグ | 現在のバージョンを表示します |
| ダウンロードURL | リリース用アセット | コンポーネントのダウンロードへのリンク |
| 最終更新日 | 更新日時 | アクティブなメンテナンス中であることを示します |
| ドキュメント | リポジトリのホームページ | ユーザーを詳細なガイドへ誘導します |
| リポジトリのリンク | リポジトリのURL | ユーザーがソースコードを閲覧できるようにします |
| ステータス | プライバシー設定 | パブリックリポジトリのみ |
結論
4D Cornerは、4Dエコシステム全体にとって双方にメリットのあるソリューションです:
- ユーザーにとって:あらかじめ構築されたコンポーネントを数秒で発見、評価、統合できます
- 貢献者にとって:数千人の開発者と自分の成果を共有し、コミュニティ内で評判を築くことができます
- コミュニティにとって:再利用可能で適切にメンテナンスされたコンポーネントを通じて、イノベーションを促進
開発を加速させるコンポーネントをお探しの方も、ご自身のコンポーネントを貢献したい方も、4D Cornerはこれらすべてを実現する中心的なハブです。
さっそく始めてみませんか? 4D Cornerにアクセスしてカタログを閲覧するか、4Dの公式ドキュメントをチェックして、コンポーネントの開発や公開についてさらに詳しく学びましょう。
現在、この投稿へのコメント機能は利用できません。