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

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

アプリケーション config は、マーケットプレイスに表示される アイデンティティを持ちます。これは、作成者、カテゴリ、ロゴ、サポート リンクです。 public/にロゴを入れ、logoUrlで参照してください。
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.',
  logoUrl: '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.json20appキーワードを追加すると、アプリが見つかります。
{ "keywords": ["twenty-app"] }

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

マーケットプレイスのリストはスクリーンショットで自分自身を販売します。 public/gallery/ にPNGをいくつかドロップして、screenshots を使って参照します。リストページでギャラリー としてレンダリングします。
export default defineApplication({
  // ...identity from above
  screenshots: [
    '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 dev --once --dry-run   # preview the metadata diff
ドライランは、それを適用せずにサーバー上で何が変更されるかを正確にプリントします — 良い最終正常性チェックです。 TestingSyncing & 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。