직접 작성하고 실행하기

웹 예제는 등록된 소스를 실행합니다. 자신이 작성한 .uni 파일을 사용하려면 Unibase compiler unic과 같은 빌드의 SDK·native 라이브러리가 필요합니다. 이 장은 이미 준비된 개발 도구 사용법입니다. 사용자용 설치 파일·다운로드 주소와 OS별 배포 지원을 새로 확정하지 않습니다.

첫 파일 검사와 실행

빈 폴더에서 다음 코드를 Hello.uni로 저장합니다.

Hello.uni

class Hello {
    static void main() {
        print("Hello, world!");
    }
}

PowerShell에서 실제 compiler 경로를 변수에 넣습니다. 아래 경로는 예시이므로 설치된 위치로 바꾸세요.

$unic = 'C:\tools\unibase\unic.exe'
& $unic toolchain
& $unic check .\Hello.uni
if ($LASTEXITCODE -ne 0) { throw 'Source check failed' }
& $unic build .\Hello.uni -o .\Hello.exe
if ($LASTEXITCODE -ne 0) { throw 'Native build failed' }
.\Hello.exe

check가 OK, 실행 결과가 Hello, world!인지 확인합니다. build 실패 뒤 이전 실행 파일을 실행하지 마세요. 종료 코드가 0인지 확인한 뒤 다음 단계로 이동합니다. 소스에서 바로 실행하려면 unic run Hello.uni를 사용할 수 있습니다.

native 빌드는 LLVM/clang과 호환되는 Standard·DB 라이브러리를 연결합니다. toolchain이 clang을 찾지 못하거나 matching UNIC_STANDARD_LIBRARY and UNIC_DATABASE_LIBRARY archives 오류가 나면 배포 패키지의 도구 구성을 확인하세요. 버전이 다른 .lib를 임의로 섞지 않습니다.

자주 쓰는 명령

목적	명령 형태	결과와 경계
문법·의미 검사	unic check Hello.uni	실행 프로그램은 main 필요
폴더 검사	unic check src	폴더의 .uni 파일을 한 프로그램으로 검사. 모델링 unit의 참조도 함께 해석
모델 참조 검사	unic check src --model	하나의 native 프로그램이 아닌 프로젝트의 모델 참조 검사. 코드는 타입 검사하지 않음
JSON 진단	unic check Hello.uni --json	모든 check 형태에 사용. 성공 여부와 관계없이 JSON 하나 출력
라이브러리 검사	unic check src --library	여러 소스의 타입·중복 검사. main 불필요, 실행하지 않음
포맷 검사	unic format Hello.uni --check	형식 차이 검사
포맷 미리보기	unic format Hello.uni --stdout	표준 출력으로 결과 읽기
다른 파일에 포맷	unic format Hello.uni -o Formatted.uni	원본과 출력 경로 구분
native 생성	unic build Hello.uni --target native -o Hello.exe	현재 도구 환경의 실행 파일
Windows UI 생성	unic build Layout.uni --target windows -o build-ui/Layout.exe	UI runtime·renderer·Windows host를 포함. 준비 조건 확인
중간 표현	unic emit Hello.uni --target llvm-ir -o Hello.ll	LLVM IR 출력. 실행 성공 증거 아님
패키지	unic pack src -o Sample.ulib --name Sample --version 1.0.0	타입 메타데이터 패키징. check/build의 대체가 아님
선언 목록	unic symbols src	선언을 JSON으로 출력. 진입점이 없거나 아직 컴파일되지 않는 프로젝트에도 사용
정의·참조 찾기	unic definition Main.uni:12:5 --project src, unic references Main.uni:12:5 --project src	위치의 이름이 가리키는 선언, 같은 선언을 가리키는 위치. 줄·열은 1부터
언어 서버	unic lsp --project src	표준 입출력의 Language Server Protocol 서버. VS Code 확장이 실행
DB DDL	unic emit src --target ddl --dialect postgresql -o schema.sql	schema database unit의 DDL. -o가 없으면 표준 출력
디버그 정보	unic build Main.uni -g -o Main.exe	native 디버거용 줄 정보. Windows에서는 실행 파일 옆에 .pdb
화면 프로젝트	unic export-ui App.uni --target vue -o generated-app	새 출력 폴더 사용. CLI 대상은 vue/react/svelte

emit은 llvm-ir/unibase-ir/wasm-wat/ui-cpp/ui-js/bridge-schema-json, 폴더나 파일에 bridge-entry, ddl(--dialect postgresql|mysql|mssql|oracle|sqlite)을, build는 windows/native/linux/web/wasm/wasm-html 이름을 받습니다. 이름을 받는 것과 현재 OS·toolchain에서 해당 소스를 빌드할 수 있는 것은 다릅니다. 실행 대상의 compiler 진단을 확인하세요. 기존 결과를 교체하는 build --force는 필요한 경우에만 사용합니다.

unibase-ir 출력에는 SQL 문장 표현식이 적어도 하나 필요합니다. SQL이 없는 Hello 예제에는 위의 llvm-ir을 사용하세요.

check·build의 --bridge는 ERWeb Desktop 같은 호스트가 실행하는 서버 없는 backend로 프로그램을 빌드합니다. 네트워크 포트를 열지 않고 표준 입출력으로 한 줄에 JSON 메시지 하나씩 주고받습니다. 추가되는 생성 소스는 unic emit <폴더> --target bridge-entry로 확인합니다.

definition·references는 검사를 통과한 파일·프로젝트에서만 답하며, 실패하면 definition이 null이고 진단을 함께 출력합니다. 여러 파일로 나눈 partial 클래스의 선언은 해석하지 않습니다.

프로젝트 파일 구성

타입 이름과 파일 이름을 맞추고 package를 폴더 구조와 함께 관리합니다. 실행 프로그램의 여러 파일은 check <directory>로 함께 검사하며, static void main()을 선언한 클래스 하나에서 시작합니다. main 없이 여러 파일의 클래스·인터페이스를 검사할 때는 check <directory> --library를 사용합니다. 이 프로필은 최대 500개 소스·8 MiB를 받습니다. 모델링 schema의 여러 파일 참조는 check <directory> 또는 --model로 검사합니다(모델링 DSL).

컴파일러 저장소에서 직접 빌드하는 개발자는 해당 리비전의 README·CMake 설정을 따릅니다. 개발자 로컬 경로가 들어 있는 빌드 명령을 일반 설치 명령으로 복사하지 않습니다.

오류에서 다음 행동 찾기

증상	확인할 것
main 누락	실행 프로그램인지 라이브러리인지 선택
Unknown type / No matching method	import·SDK 기준·인수 타입
Native method unavailable	선언과 연결한 런타임 버전, 대상 지원
native lowering 미지원	다른 생성 대상의 지원표 또는 지원 문법 사용
출력이 예상과 다름	stdout/stderr·종료 코드·실제 생성 파일 비교
생성 폴더 충돌	새 빈 출력 위치 선택, 기존 작업을 임의 삭제하지 않음

다음은 Standard 예제, 코드 생성, 개발 도구입니다.