6. 公開

アプリは動作します。最後のステップは、マーケットプレイスのためにそれを説明し、公開することです。

マーケットプレイスのメタデータを追加

アプリケーション config は、マーケットプレイスに表示されるアイデンティティを持ちます。これは、作成者、カテゴリ、ロゴ、サポートリンクです。 public/にロゴを入れて、logoで参照してください。

import { defineApplication } from 'twenty-sdk/define';

export default defineApplication({
  universalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,
  displayName: 'Document Generator',
  description:
    'Create reusable document templates and generate personalized documents from your CRM records.',
  logo: 'public/document-generator.svg',
  author: 'Twenty',
  category: 'Productivity',
  websiteUrl: 'https://docs.twenty.com/l/ja/developers/extend/apps',
  termsUrl: 'https://www.twenty.com/terms',
  emailSupport: 'contact@twenty.com',
  issueReportUrl: 'https://github.com/twentyhq/twenty/issues',
});

既定のロールは、専用のファイル内で defineApplicationRole() を使って宣言します。ここでは defaultRoleUniversalIdentifier を渡す必要はもうありません。

package.jsonに20appキーワードを追加すると、アプリが見つかります。

{ "keywords": ["twenty-app"] }

ギャラリースクリーンショットを追加

マーケットプレイスのリストはスクリーンショットで自分自身を販売します。 public/gallery/にPNGをいくつかドロップし、galleryImagesで参照します。リストページのギャラリーとして表示されます。行列の順序で入力します。

export default defineApplication({
  // ...identity from above
  galleryImages: [
    'public/gallery/01-generated-document.png',
    'public/gallery/02-command-menu.png',
    'public/gallery/03-template-editor.png',
    'public/gallery/04-documents.png',
  ],
});

ペイオフでリード: 最初のスクリーンショットを完成結果(生成されたドキュメント)にし、それがどのようにトリガーされ、作成されたかを表示します。鮮明で高解像度のキャプチャを使用する — これはユーザーが最初に目にするものです。

README.md にも同じ処理を与えます。npm と GitHub のトップページです。値のプロポジションとスクリーンショットで開き、見出しの機能を一覧表示してから、ビルドの詳細を折り目以下に保ちます。

出荷前に確認

CI と同じゲートを実行します。

yarn lint          # oxlint
yarn typecheck     # tsgo
yarn test:unit     # unit tests
yarn twenty plan   # preview the metadata diff

このプランは、適用せずにサーバー上で何が変わるかを正確に出力します。最終確認として有用です。 Testing と Syncing & recovery を参照してください。

公開

# Public app → npm (default)
yarn twenty app:publish

# Or deploy privately to a specific server's registry
yarn twenty app:publish --private -r <remote>

app:publish はデフォルトで npm にビルドおよび公開します。--private は代わりに tarball を Twenty サーバーのプライベートレジストリにアップロードします。公開されたアプリをマーケットプレイスで表示するには、カタログ同期をトリガーします。

yarn twenty dev:catalog-sync -r <remote>

詳細とリリースのチェックリスト: Publishing.

あなたはアプリを構築しました 🎉

6つのチャプターでは、SDKのほとんどを使用しました。

データをモデル化するためのオブジェクト、フィールド、リレーション
AIツール、ワークフローアクション、HTTPルートとして公開されるロジック関数
UIの表示、ナビゲーション、コマンド、フロントコンポーネント
自然言語生成のための エージェント + スキル
マーケットプレースのメタデータ とパブリッシュフロー

完成したアプリは packages/20apps/examples/document-generatorにあります。

次の場所へ

データ参照

すべてのフィールドタイプ、リレーション、インデックスオプション。

ロジックリファレンス

Cronとdatabase-event トリガー、キー値ストア、OAuth 接続。

レイアウト参照

ページレイアウト、ダッシュボードウィジェット、およびより多くのUIサーフェス。

オペレーション

CLI、テスト、リモコン、CI。

概要

アプリ

API

セルフホスト

貢献

マーケットプレイスのメタデータを追加

ギャラリースクリーンショットを追加

出荷前に確認

公開

あなたはアプリを構築しました 🎉

次の場所へ

データ参照

ロジックリファレンス

レイアウト参照

オペレーション

​マーケットプレイスのメタデータを追加

​ギャラリースクリーンショットを追加

​出荷前に確認

​公開

​あなたはアプリを構築しました 🎉

​次の場所へ

データ参照

ロジックリファレンス

レイアウト参照

オペレーション

マーケットプレイスのメタデータを追加

ギャラリースクリーンショットを追加

出荷前に確認

公開

あなたはアプリを構築しました 🎉

次の場所へ