tauri.conf.json, 필드 하나씩

"설정 파일은 웹 반쪽이랑 네이티브 반쪽이 맺은 계약서야. 계약서 읽듯이 읽어."

중요한 네 구역

tauri.conf.json은 작아도 하는 일은 커. 최상위 네 구역이 거의 전부를 처리해:

신원 — productName, version, identifier(com.acme.myapp 같은 역DNS 문자열). identifier로 OS가 네 앱 데이터 폴더 이름을 짓고 번들에 서명해.
build — 프론트엔드를 어떻게 붙일지. beforeDevCommand(dev 서버 띄우기), devUrl(그게 어디 사는지, 이를테면 http://localhost:1420), beforeBuildCommand(프로덕션 빌드), frontendDist(Tauri가 실어 보낼 정적 파일 폴더).
app — 돌아갈 때의 UI. 처음 뜨는 windows 배열(크기, 제목, resizable…)이랑 security(특히 Content Security Policy).
bundle — 패키징. 번들링을 active로 둘지, 어떤 targets를 만들지(.dmg, .msi, AppImage…), icon 세트는 뭔지.

devUrl vs frontendDist: dev/prod 스위치

이 한 쌍에서 누구나 한 번은 헷갈려. dev일 땐 Tauri가 웹뷰를 devUrl 쪽으로 돌려놔 — 핫리로드가 도는 살아 있는 dev 서버. build일 땐 서버가 없어. Tauri가 앱 안에 실어둔 frontendDist의 정적 파일을 읽어. 같은 앱인데 HTML 먹이는 방식이 둘인 거지. dev는 되는데 빌드한 앱만 빈 창이 뜨면, frontendDist가 엉뚱한 폴더를 가리키는 게 흔한 범인이야.

스키마 줄을 켜두면 편해

첫 줄 "$schema": "https://schema.tauri.app/config/2"는 장식이 아냐 — 에디터에 모든 필드의 자동완성이랑 검증을 붙여줘. 에디터에서 키가 빨개지면 오타거나 v2엔 없는 키야. v1 시절에 쓰인 블로그보다 스키마를 믿어.

Code

진짜 모양의 tauri.conf.json (Cinder가 쓰는 구조 그대로)·json

{
  "$schema": "https://schema.tauri.app/config/2",
  "productName": "My App",
  "version": "1.0.0",
  "identifier": "com.acme.myapp",
  "build": {
    "beforeDevCommand": "npm run dev",
    "devUrl": "http://localhost:1420",
    "beforeBuildCommand": "npm run build",
    "frontendDist": "../dist"
  },
  "app": {
    "windows": [
      { "title": "My App", "width": 1200, "height": 800, "resizable": true }
    ],
    "security": { "csp": null }
  },
  "bundle": {
    "active": true,
    "targets": "all",
    "icon": ["icons/128x128.png", "icons/icon.icns", "icons/icon.ico"]
  }
}

Exercise

스캐폴딩한 앱의 tauri.conf.json을 열어. 창 제목이랑 inner size를 바꾸고 tauri dev를 돌려서 네이티브 창에 반영되는지 확인해. 그다음 identifier를 찾아봐 — 진짜 역DNS 문자열이야, 아니면 스캐폴더가 남겨둔 임시값이야? 릴리스 빌드를 한 번이라도 돌리기 전에 지금 고쳐.

Hint

창 설정은 app.windows[0] 아래에 있어. identifier는 최상위 키고. 아직 com.tauri-app.dev 같은 거면 자리만 채워둔 값이야 — com.네이름.앱이름으로 바꿔.