리눅스 앱의 창을 만들 때 버튼과 입력창 위치를 GTK XML 파일에 처음부터 적으려면 화면을 확인하며 고치기가 번거롭습니다. Cambalache는 GTK 4와 GTK 3 인터페이스의 위젯을 화면에서 배치하고 속성을 조정하는 도구입니다. Flathub의 무료 배포 버전은 1.2.0이며 Linux x86_64·aarch64에서 제공됩니다. 이 글은 작은 창에 글자와 버튼을 놓는 예시로 새 프로젝트, 위젯 선택, .ui 파일 확인 순서를 짚습니다.
Cambalache 1.2.0 리눅스 무료 다운로드·설치 안내
GTK 화면 구조를 보면서 위젯을 배치합니다
Cambalache는 애플리케이션 실행 코드를 대신 작성하는 도구가 아니라 GtkBuilder에 쓰일 인터페이스 구조를 만드는 작업 화면입니다. 개발자가 공개한 GTK 글은 창, 레이블, 버튼, 입력창 같은 위젯을 놓고 속성과 시그널을 지정할 수 있다고 설명합니다. 창 안에 어떤 컨테이너와 버튼을 넣을지 먼저 정해 두면 UI 파일의 구조를 읽고 수정하기 쉽습니다.
Flathub의 현재 항목은 GTK 4/3용 RAD 도구라고 소개합니다. 새 프로젝트를 만들 때 GTK 3과 GTK 4 중 대상을 고르는 공식 예시 화면도 있습니다. GTK 4 앱을 만든다면 시작 화면에서 GTK 4를 선택하고, 이미 만든 GTK 3 화면을 가져오는 작업이라면 프로젝트가 실제로 사용하는 버전을 먼저 확인해야 합니다. 두 대상의 위젯이나 속성이 항상 같다고 가정하면 작업 중 혼동하기 쉽습니다.
공식 작업 화면에는 왼쪽 프로젝트 트리, 가운데 창 미리보기, 오른쪽 속성 패널이 나옵니다. 예시에는 GtkWindow 안에 GtkBox와 GtkGrid가 있고, GtkButton의 label 값을 바꾸는 모습이 보입니다. 트리에서 선택한 객체와 오른쪽 속성 패널의 이름이 같은지 확인한 뒤 값을 고치면 다른 버튼의 글자를 바꾸는 실수를 줄일 수 있습니다.
Flathub에 올라온 화면은 시작 창에 version 1.0을 표시합니다. 현재 배포 페이지의 변경 내역은 1.2.0이므로, 이 이미지는 기능을 이해하는 공식 예시로 봐야 합니다. 설치한 1.2.0에서 메뉴나 패널 위치가 조금 다르면 화면의 프로젝트, 위젯, 속성 같은 역할을 기준으로 찾으세요. 화면에 있는 예시 버전을 현재 배포 버전으로 바꾸어 읽지 않는 것이 정확합니다.
처음 화면을 만들 때는 큰 앱을 한 번에 따라 하기보다 창 하나와 버튼 하나로 구조를 확인하는 편이 좋습니다. 창을 만든 다음 버튼이 어느 컨테이너 아래에 놓였는지 트리에서 보고, 가운데 미리보기에서 표시 문구가 바뀌는지 확인하세요. 오른쪽 패널의 속성을 바꾼 뒤에는 저장된 UI 파일도 살펴봅니다. 이렇게 하면 디자인 화면에서 보이는 변화와 앱 코드가 읽을 파일 사이의 연결을 이해할 수 있습니다. 버튼이 안 보일 때는 새 버튼을 계속 추가하기 전에 트리의 부모와 선택한 UI 파일부터 확인하는 것이 더 정확한 순서입니다.
새 프로젝트와 GTK 위젯 편집 화면
Flathub가 공개한 1.0 예시 화면입니다. 새 프로젝트에서 GTK 4를 고르는 창, 버튼 label 편집, 위젯 예시를 보여 줍니다. 현재 배포 1.2.0의 세부 배치는 다를 수 있습니다.
Cambalache 1.2.0 리눅스 무료 다운로드·설치 안내
| 프로그램 | Cambalache |
| 확인 버전 | 1.2.0 |
| 지원 환경 | Linux x86_64·aarch64 |
| 가격 | 무료 |
| 주요 용도 | GTK 4·3 UI 화면 설계 |
| 배포 | Flathub |
Flathub에서 Cambalache 1.2.0을 설치합니다
Flathub의 Cambalache 항목에서 무료 표시와 1.2.0 변경 내역을 확인하세요. 지원 아키텍처는 Linux x86_64와 aarch64입니다. 사용 중인 리눅스 배포판에서 Flathub 앱을 설치하도록 설정한 뒤 Install을 누르고 앱 이름과 ID ar.xjuan.Cambalache를 대조합니다. 별도 Windows 설치 파일이나 macOS 앱을 이 Linux 안내에 포함하지 않습니다.
프로젝트의 공식 GTK 블로그도 Flathub 설치 명령에서 같은 앱 ID를 사용합니다. 블로그는 1.0 시점에 작성된 사용법이므로 다운로드 버전은 현재 Flathub 항목의 1.2.0을 기준으로 확인하세요. 설명을 따라가기 위해 오래된 예시 버전 패키지를 찾아 설치할 필요는 없습니다. Flathub에서 설치가 끝나면 앱 목록에서 Cambalache를 열어 시작 화면이 나타나는지 봅니다.
Cambalache를 열고 바로 GTK 앱이 완성되는 것은 아닙니다. 이 도구는 화면 정의를 만드는 편집기이므로 프로젝트 폴더와 UI 파일 이름을 정해야 합니다. 화면에 다른 앱의 파일이 이미 열려 있다면 새 프로젝트를 만들기 전에 저장 위치와 현재 파일을 확인하세요. 처음에는 빈 폴더를 하나 정하고 작은 연습용 화면으로 시작하는 편이 결과 파일을 찾기 쉽습니다.
Flathub에서 보이는 다운로드 크기와 앱을 설치한 뒤 차지하는 저장 공간은 서로 다른 값입니다. 설치 전에는 디스크 여유 공간과 현재 배포판의 Flatpak 설정을 확인하세요. 설치 과정에서 앱 이름이나 저장소가 예상과 다르게 나오면 계속 진행하기보다 Flathub 항목으로 돌아가 앱 ID를 다시 대조하는 것이 안전합니다. 이 글의 안내는 Flathub의 Linux 패키지 하나에 맞춰져 있습니다.
- Flathub의 Cambalache 항목에서 무료·1.2.0·Linux 환경을 확인합니다.
- Install을 선택하고 앱 ID ar.xjuan.Cambalache를 확인합니다.
- 앱을 열어 프로젝트 시작 화면이 보이는지 확인합니다.
새 프로젝트에서 GTK 4와 UI 파일 위치를 정합니다
개발자의 사용 안내에 따르면 Ctrl+N 또는 메뉴의 New Project로 새 프로젝트 창을 엽니다. 공식 이미지에는 Project Name, UI Filename, Location, Toolkit Target이 나란히 보입니다. GTK 4 화면을 만들 목적이라면 Toolkit Target에서 Gtk 4를 고른 뒤 프로젝트 이름과 저장할 폴더를 정하세요. 예시의 my-gtk4-app.ui는 설명용 파일 이름이므로 자신의 앱에 맞는 이름을 쓰면 됩니다.
프로젝트 파일과 UI 파일을 서로 헷갈리지 마세요. 공식 프로젝트 안내는 파일 경로가 프로젝트 파일 기준 상대 경로로 저장된다고 설명합니다. 작업 폴더를 나중에 옮길 계획이라면 한 상위 폴더 아래에 프로젝트와 필요한 UI 파일을 함께 두는 편이 경로를 이해하기 쉽습니다. 새 프로젝트를 만든 뒤 왼쪽 트리에 생성된 UI 파일 이름이 예상과 같은지 먼저 확인합니다.
이미 GtkBuilder 파일이 있는 경우에는 빈 화면을 다시 그릴 필요가 없습니다. 공식 안내에는 파일 단위 가져오기와 Import directory가 있어 기존 프로젝트의 UI, CSS, GResource 파일을 읽는다고 나옵니다. 다만 처음 저장할 때 속성과 시그널의 출력 순서가 바뀔 수 있다는 안내도 있으므로, 기존 파일을 가져오기 전에는 원본을 별도로 보존하고 변경 내용을 비교하세요. 이 글의 첫 작업은 새 프로젝트 만들기를 기준으로 합니다.
GTK 4를 선택했는데 가져온 파일이 GTK 3 기준이라면 화면을 고치기 전에 파일의 대상 버전을 확인해야 합니다. 새 프로젝트의 Toolkit Target과 가져오는 UI 정의의 버전이 다르면 일부 위젯이나 속성 이름이 예상과 다를 수 있습니다. 처음 배우는 단계라면 기존 앱 전체를 가져오기보다 새 프로젝트에 창 하나만 만들어 GTK 4 파일이 생성되는 순서를 익히세요. 이후 실제 프로젝트를 옮길 때 바뀐 점을 구분하기 쉽습니다.
- New Project를 열고 프로젝트 이름과 저장 위치를 정합니다.
- Toolkit Target에서 Gtk 4를 선택합니다.
- 생성된 프로젝트와 .ui 파일 이름을 왼쪽 트리에서 확인합니다.
창에 버튼을 놓고 label 속성을 바꿉니다
프로젝트를 만들었다면 가운데 작업 영역에 창과 배치용 컨테이너를 추가합니다. 공식 안내는 위젯 선택 막대를 Toplevel, Layout, Control, Display, Model 등으로 나눕니다. 창을 먼저 두고 필요한 위치에 Box나 Grid를 배치한 다음 버튼을 넣는 순서로 생각하면 좋습니다. 공식 화면에서도 GtkWindow 아래 GtkBox, GtkGrid, GtkLabel, GtkButton이 트리 형태로 정리되어 있습니다.
가운데 화면의 빈 자리에는 다음 위젯을 넣을 수 있는 자리표시자가 나타납니다. 공식 사용 안내는 위젯 종류를 선택한 뒤 자리표시자를 누르거나 객체 트리의 문맥 메뉴를 쓸 수 있다고 합니다. 작은 버튼 하나를 넣을 때에도 부모 컨테이너가 무엇인지 왼쪽 트리에서 확인하세요. 버튼을 넣을 위치와 창 전체의 배치를 바꾸는 작업은 서로 다릅니다.
예시 화면은 GtkButton을 선택한 상태에서 오른쪽 Properties 패널의 label 값이 Mundo로 바뀌는 모습을 보여 줍니다. 처음에는 한 버튼의 표시 문구만 바꾸고 가운데 미리보기와 트리에서 같은 객체가 선택되어 있는지 확인하세요. Signals 탭은 버튼을 눌렀을 때 연결할 동작을 정의하는 곳이지만, 화면 편집만으로 실제 앱 로직이 자동 생성되지는 않습니다. 동작 코드는 사용 중인 GTK 프로젝트에서 따로 연결해야 합니다.
버튼 글자가 바뀌지 않는다면 먼저 오른쪽 패널의 객체 유형이 GtkButton인지 보세요. 트리에서 GtkWindow나 GtkGrid가 선택된 상태로 다른 속성을 수정하면 원하는 버튼에는 변화가 없습니다. 글자 자체는 바뀌었지만 화면 안의 위치가 어긋나 보인다면 label이 아니라 부모 Box나 Grid의 배치를 살펴야 합니다. 어떤 객체를 고쳤는지 트리와 속성 패널을 함께 읽으면 문제의 위치를 좁힐 수 있습니다.
- Toplevel에서 창을 만들고 Layout에서 배치용 위젯을 고릅니다.
- Control에서 버튼을 추가한 뒤 왼쪽 트리에서 GtkButton을 선택합니다.
- Properties의 label을 바꾸고 가운데 미리보기에 반영되는지 확인합니다.
UI 파일을 확인하고 기존 프로젝트와 연결합니다
Cambalache의 작업 결과는 GTK 앱이 불러올 UI 정의와 연결됩니다. 개발자 글은 GtkBuilder XML UI 파일과 템플릿뿐 아니라 Blueprint, GResources, CSS를 프로젝트에서 다룰 수 있다고 설명합니다. 처음 만든 창이라면 .ui 파일의 창·버튼 구조가 원하는 순서인지 확인하는 데 집중하세요. CSS나 리소스를 동시에 추가하면 어떤 변경 때문에 화면이 달라졌는지 찾기 어렵습니다.
저장한 뒤에는 UI 파일 경로와 이름을 프로젝트 코드에서 참조하는 위치와 맞춥니다. Cambalache에서 미리보기가 보인다는 이유만으로 앱 안에서도 같은 화면이 자동으로 열리는 것은 아닙니다. GTK 앱에서 GtkBuilder 파일을 불러오고 필요한 시그널을 코드에 연결해야 실제 버튼이 동작합니다. 파일을 옮겼다면 상대 경로를 다시 확인하고 앱에서 창이 뜨는지 별도로 점검하세요.
위젯은 보이는데 속성이 적용되지 않는다면 왼쪽 트리에서 선택한 객체와 오른쪽 편집 대상이 같은지 먼저 살펴보세요. 창이 비어 있다면 GTK 4로 시작한 프로젝트에 맞는 UI 파일을 열었는지와 컨테이너 안에 자식 위젯이 들어 있는지를 확인합니다. 기존 파일 가져오기 후에는 원본과 저장본을 비교해 변경된 속성이나 순서를 확인하세요. 이 확인은 화면을 새로 그리는 것보다 문제 범위를 빨리 좁혀 줍니다.
화면을 다 만든 뒤에도 작은 수정 한 번을 저장하고 결과 파일을 열어 보는 과정이 필요합니다. 프로젝트 파일만 확인하고 .ui 파일을 놓치면 앱 코드가 무엇을 읽어야 하는지 알기 어렵습니다. 파일 이름을 다시 정했다면 개발 프로젝트의 로딩 경로도 그 이름에 맞춰 바꾸세요. 개발자의 공식 글은 GtkBuilder UI 파일과 코드가 따로 연결되는 구조를 설명하므로, 편집기 미리보기와 앱 실행 결과를 같은 검증으로 취급하지 않는 편이 좋습니다.
자주 묻는 질문
Cambalache는 무료인가요?
네. Flathub가 무료로 표시하며 확인한 Linux 배포 버전은 1.2.0입니다.
GTK 3 프로젝트도 만들 수 있나요?
Flathub는 GTK 4/3 UI 도구라고 안내합니다. 새 프로젝트에서 만들 앱의 Toolkit Target을 맞춰 고르세요.
화면 사진에 1.0이 있는데 왜 버전은 1.2.0인가요?
이미지는 Flathub가 공개한 예시 화면이고 현재 Flathub 배포 버전은 1.2.0입니다. 패널 위치가 달라질 수 있습니다.
Cambalache만 설치하면 앱 코드도 만들어지나요?
아니요. 이 도구는 UI 구조를 만들고 속성과 시그널을 지정하는 편집기입니다. 동작 코드는 GTK 프로젝트에서 따로 작성합니다.
기존 .ui 파일을 가져올 수 있나요?
공식 안내에 파일과 디렉터리 가져오기가 있습니다. 처음 저장할 때 출력 순서가 달라질 수 있으니 원본을 보존하세요.
작은 창 하나를 만든 뒤 .ui 파일부터 확인하세요
Cambalache로 리눅스에서 GTK 4 앱 화면을 만들려면 Flathub의 1.2.0 앱을 설치하고 새 프로젝트에서 Gtk 4를 고르세요. 창과 배치용 컨테이너를 만든 다음 버튼 하나를 추가해 label을 바꾸고, 생성된 UI 파일 이름과 저장 위치를 확인하면 첫 화면을 정리할 수 있습니다. 앱의 실제 동작과 파일 로딩은 GTK 프로젝트 코드에서 이어서 연결합니다. 기존 UI를 가져올 때는 원본을 보존하고 저장본을 비교하세요.
공식 자료와 확인일
Cambalache Flathub 무료 배포·버전·지원 환경 · GTK 개발자 공식 Cambalache 사용 안내 · Cambalache 공식 프로젝트 | 2026-11-11T04:50:24.031065+00:00
Cambalache 1.2.0 리눅스 무료 다운로드·설치 안내
