公共资源

应用根目录中的 public/ 文件夹包含静态文件——图像、图标、字体，或应用在运行时所需的任何其他资源。这些文件会在构建时自动包含、在开发模式下同步，并上传到服务器。放置在 public/ 中的文件：

公开可访问——同步到服务器后，资源将通过公共 URL 提供服务。访问它们无需身份验证。
在前端组件中可用——使用资源 URL 在 React 组件中显示图像、图标或任何媒体。
在逻辑函数中可用——在电子邮件、API 响应或任何服务端逻辑中引用资源 URL。
用于市场元数据——defineApplication() 中的 logo 和 galleryImages 字段引用此文件夹中的文件（例如，public/logo.png）。应用发布后，这些内容会显示在市场中。对于这些字段，外部绝对 URL 会被忽略——请改为将图像打包到 public/ 中。每个图片文件大小不得超过 10 MB。
在开发模式下自动同步——当在 public/ 中添加、更新或删除文件时，会自动同步到服务器。无需重启。
包含在构建中——yarn twenty dev:build 会将所有公共资源打包到分发产物中。

使用 `getPublicAssetUrl` 访问公共资源

使用来自 twenty-sdk 的 getPublicAssetUrl 辅助函数获取 public/ 目录中文件的完整 URL。它可在 逻辑函数 和 前端组件 中使用。 在逻辑函数中：

src/logic-functions/send-invoice.ts

import { defineLogicFunction } from 'twenty-sdk/define';
import { getPublicAssetUrl } from 'twenty-sdk/utils';

const handler = async (): Promise<any> => {
  const logoUrl = getPublicAssetUrl('logo.png');
  const invoiceUrl = getPublicAssetUrl('templates/invoice.png');

  // Fetch the file content (no auth required — public endpoint)
  const response = await fetch(invoiceUrl);
  const buffer = await response.arrayBuffer();

  return { logoUrl, size: buffer.byteLength };
};

export default defineLogicFunction({
  universalIdentifier: 'a1b2c3d4-...',
  name: 'send-invoice',
  description: 'Sends an invoice with the app logo',
  timeoutSeconds: 10,
  handler,
});

在前端组件中：

src/front-components/company-card.tsx

import { defineFrontComponent } from 'twenty-sdk/define';
import { getPublicAssetUrl } from 'twenty-sdk/utils';

const CompanyCard = () => {
  const logoUrl = getPublicAssetUrl('logo.png');

  return <img src={logoUrl} alt="App logo" />;
};

export default defineFrontComponent({
  universalIdentifier: '...',
  name: 'company-card',
  component: CompanyCard,
});

path 参数是相对于应用的 public/ 文件夹的。 getPublicAssetUrl('logo.png') 和 getPublicAssetUrl('public/logo.png') 均解析为相同的 URL——如果存在，public/ 前缀会被自动移除。

概览

应用

接口

自托管

贡献

使用 `getPublicAssetUrl` 访问公共资源

​使用 getPublicAssetUrl 访问公共资源

使用 `getPublicAssetUrl` 访问公共资源