Tauri(파트 - 먼저 창 구성을 올바르게 설정하세요.-JS 튜토리얼-php.cn

Tauri (Part - Get the window configuration right first

머리말

데스크톱 애플리케이션을 개발할 때 창 매개변수를 이해하고 올바르게 구성하는 것이 중요합니다. 기능을 간소화하고 사용자 경험을 최적화하는 데 도움이 됩니다.

다음 콘텐츠는 Tauri 2 공식 문서를 기반으로 하며 기능, 기본값 및 적용 가능성을 포함하여 WindowConfig 구성 매개변수에 대한 자세한 설명을 제공합니다.

기본 창 동작

매개변수	유형	설명	기본값
FirstMouse 수락	부울	창에서 첫 번째 마우스 이벤트를 허용할지 여부(macOS만 해당)	거짓
alwaysOnBottom	부울	창이 항상 다른 창 아래에 위치하는지 여부	거짓
alwaysOnTop	부울	창이 항상 다른 창 위에 위치하는지 여부	거짓
배경색상	문자열	창의 배경색(16진수 형식)	기본값 없음
센터	부울	창이 화면 중앙에 있는지 여부	거짓
폐쇄 가능	부울	창문을 닫을 수 있는지 여부	그렇습니다
콘텐츠 보호됨	부울	창 내용이 캡처되거나 기록되지 않도록 보호합니다(부분 지원).	거짓
장식	부울	창 장식(제목 표시줄, 테두리 등) 표시 여부	그렇습니다
드래그드롭 활성화됨	부울	드래그 앤 드롭 기능이 활성화되어 있는지 여부	그렇습니다
집중	부울	실행 시 창이 포커스를 받는지 여부	그렇습니다
전체 화면	부울	창이 전체 화면 모드로 시작되는지 여부	거짓
숨겨진 제목	부울	제목 표시줄을 숨깁니다(macOS만 해당).	거짓
시크릿	부울	데이터 추적을 방지하기 위해 시크릿 모드를 활성화합니다.	거짓
라벨	문자열	창의 고유 식별자(필수).	기본값 없음
최대화 가능	부울	창을 최대화할 수 있는지 여부	그렇습니다
최대화	부울	창이 최대화되기 시작하는지 여부	거짓
최소화 가능	부울	창을 최소화할 수 있는지 여부	그렇습니다
크기 조정 가능	부울	창 크기 조절 가능 여부	그렇습니다
작업 표시줄 건너뛰기	부울	작업 표시줄에서 창을 숨깁니다(플랫폼에 따라 다름).	거짓
탭 식별자	문자열	창 그룹화 식별자(macOS만 해당)	기본값 없음
테마	"빛" 또는 "어두움"	창의 기본 테마, 부분적으로 지원됩니다.	시스템 기본값
제목	문자열	창 제목.	"타우리 앱"
titleBarStyle	문자열	제목 표시줄 스타일(macOS 등 플랫폼에 따라 다름)	기본 스타일
투명	부울	창 투명도를 활성화합니다(부분 지원).	거짓
userAgent	문자열	창용 사용자 정의 사용자 에이전트.	기본값 없음
표시	부울	창이 보이는지.	그렇습니다
visibleOnAllWorkspaces	부울	창을 모든 작업 공간에 표시합니다(macOS만 해당).	거짓
windowClassname	문자열	사용자 정의 창 클래스 이름(Windows에만 해당).	기본값 없음
zoomHotkeysEnabled	부울	창에 확대/축소 단축키를 활성화합니다.	그렇습니다

치수 및 위치

Parameter	Type	Description	Default Value
width	number	Initial width of the window (in pixels).	800
height	number	Initial height of the window (in pixels).	600
minWidth	number	Minimum width of the window (in pixels).	No default value
minHeight	number	Minimum height of the window (in pixels).	No default value
maxWidth	number	Maximum width of the window (in pixels).	No default value
maxHeight	number	Maximum height of the window (in pixels).	No default value
x	number	Initial X-axis position of the window (from screen top-left).	Centered
y	number	Initial Y-axis position of the window (from screen top-left).	Centered

매개변수 유형 설명 기본값 너비 번호 창의 초기 너비(픽셀 단위). 800 키 번호 창의 초기 높이(픽셀 단위). 600 최소 너비 번호 창의 최소 너비(픽셀 단위). 기본값 없음 최소 높이 번호 창의 최소 높이(픽셀 단위). 기본값 없음 최대 너비 번호 창의 최대 너비(픽셀 단위). 기본값 없음 최대 높이 번호 창의 최대 높이(픽셀 단위) 기본값 없음 x 번호 창의 초기 X축 위치(화면 왼쪽 상단부터) 중앙 y 번호 창의 초기 Y축 위치(화면 왼쪽 상단부터) 중앙

브라우저 기능

Parameter	Type	Description	Default Value
additionalBrowserArgs	string	Additional command-line arguments for the browser.	No default value
browserExtensionsEnabled	boolean	Enables support for browser extensions.	false
proxyUrl	string	Custom proxy URL.	No default value
useHttpsScheme	boolean	Forces the use of HTTPS.	false

창 효과

Parameter	Type	Description	Default Value
shadow	boolean	Whether the window shows a shadow (platform-dependent).	true
windowEffects	string	Custom window effects (e.g., blur, transparency).	No default value

JSON 구성 예

src-tauri/tauri.conf.json

{
  "$schema": "https://schema.tauri.app/config/2.0.0",
  "productName": "Coco AI",
  "version": "0.1.0",
  "identifier": "rs.coco.app",
  "build": {
    "beforeDevCommand": "pnpm dev",
    "devUrl": "http://localhost:1420",
    "beforeBuildCommand": "pnpm build",
    "frontendDist": "../dist"
  },
  "app": {
    "macOSPrivateApi": true,
    "windows": [
      {
        "acceptFirstMouse": false, // Whether the first mouse event is accepted
        "additionalBrowserArgs": "", // Additional arguments passed to the browser
        "alwaysOnBottom": false, // Whether the window always stays at the bottom
        "alwaysOnTop": false, // Whether the window always stays on top
        "backgroundColor": "#ffffff", // Background color of the window (default is white)
        "browserExtensionsEnabled": false, // Whether browser extensions are enabled
        "center": true, // Whether the window is centered
        "closable": true, // Whether the window can be closed
        "contentProtected": false, // Whether content protection is enabled (prevents screenshots)
        "create": true, // Whether to display the window when created
        "decorations": true, // Whether to display window decorations
        "devtools": false, // Whether developer tools are enabled (disabled by default in production)
        "dragDropEnabled": true, // Whether drag-and-drop functionality is enabled
        "focus": true, // Whether the window is focused
        "fullscreen": false, // Whether the window is in fullscreen mode
        "height": 600, // Window height (default 600px)
        "hiddenTitle": false, // Whether the window title bar is hidden
        "incognito": false, // Whether incognito mode is enabled
        "label": "main", // Unique label (identifier) of the window
        "maxHeight": null, // Maximum height of the window (default is unlimited)
        "maximizable": true, // Whether the window can be maximized
        "maximized": false, // Whether the window is maximized by default
        "maxWidth": null, // Maximum width of the window (default is unlimited)
        "minHeight": 300, // Minimum height of the window (default 300px)
        "minimizable": true, // Whether the window can be minimized
        "minWidth": 300, // Minimum width of the window (default 300px)
        "parent": null, // Parent window (default is none)
        "proxyUrl": "", // Proxy URL
        "resizable": true, // Whether the window is resizable
        "shadow": true, // Whether the window shadow is displayed
        "skipTaskbar": false, // Whether to skip showing the window in the taskbar
        "tabbingIdentifier": null, // Identifier for grouping windows
        "theme": "light", // Window theme (default is light)
        "title": "Tauri App", // Window title
        "titleBarStyle": "default", // Title bar style
        "transparent": false, // Whether the window is transparent
        "url": "/", // Default URL of the window
        "useHttpsScheme": false, // Whether to enforce HTTPS
        "userAgent": null, // Custom user agent (default is null)
        "visible": true, // Whether the window is visible
        "visibleOnAllWorkspaces": false, // Whether the window is visible on all workspaces
        "width": 800, // Window width (default 800px)
        "windowClassname": "", // Window class name (customizable)
        "windowEffects": null, // Window effects (default is none)
        "x": null, // Initial X-coordinate of the window position
        "y": null, // Initial Y-coordinate of the window position
        "zoomHotkeysEnabled": true // Whether zoom hotkeys are enabled
      }
    ],
    "security": {
      "csp": null
    }
  }
}

로그인 후 복사