# 실제 Mac 앱 빌드·게시와 검증 과정 현재 배포의 서명은 [고정 인증서·권한 유지 검증](MAC_FIXED_SIGNING.ko.md)을 따른다. 아래의 ad-hoc 관련 기록은 당시 빌드의 이력이다. 2026-09-26 · progress-27 · F01 / F61 / F82 · E02 / E05 후속 progress-28: 권한 승인 후 사용자가 Mac→Windows 화면 연결을 확인했다. 현재 게시 빌드는 **1790445294**이며 [Decode 40ms 조사·Mac H.264 저지연 수정](MAC_STREAM_LATENCY.ko.md)을 참고한다. 아래 빌드·시험은 최초 네이티브 게시 시점의 기록이다. **Apple Silicon 앱을 실제 Mac에서 빌드하고 게시했다.** 빌드는 `1790443069`, 버전은 `0.1.0`이다. [기기 관리](https://remote.n3m.kr/)에서 관리자 로그인 후 macOS → Apple Silicon을 선택한다. Intel 파일은 아직 준비 중이며, Apple 공증·Mac 자동 업데이트·Windows와의 실제 원격 세션 검증은 남아 있다. ## 1. 웹 버튼과 실행 가능한 앱의 차이 progress-26은 운영체제별 웹 표시, 두 아키텍처의 다운로드 API, 패키징·게시 경로를 구현한 단계였다. Linux에서 Mac용 모듈의 타입 검사가 통과해도 Apple SDK로 링크한 실제 앱은 만들어지지 않는다. 이번에는 외부 네트워크의 Mac에 연결해 전체 앱을 네이티브로 컴파일했다. 환경은 Apple Silicon arm64, macOS 26.5.2 (25F84), Xcode Command Line Tools의 Apple clang 17.0.0, Rust 1.93.1이다. 기존 시스템 설정을 바꾸지 않고 전용 사용자 빌드 폴더에 Rust와 미디어 도구를 준비했다. 작업 폴더의 미커밋 변경도 소스 스냅샷에 포함했으므로, 앱에 기록한 Git commit은 기반 커밋이며 깨끗한 태그 릴리스라고 주장하지 않는다. ## 2. 서로 다른 공유기에서 빌드 Mac에 접근하기 이번 Tailscale 연결은 Ubuntu가 Mac에서 컴파일하도록 만든 **개발용 SSH 경로**다. notParsec 사용자의 영상 연결을 Tailscale 필수 구조로 바꾼 것이 아니다. 제품의 Direct UDP / WSS 경로와 별개다. Ubuntu의 사용자 공간 Tailscale과 Mac을 같은 네트워크에 등록하고, Mac의 원격 로그인에서 현재 macOS 사용자를 허용했다. SSH 공개키는 접속을 허용하는 키 목록에 넣고 개인키는 Ubuntu에 보관한다. 키에 `restrict` 옵션을 붙여 명령·파일 전송에 필요 없는 포워딩 등을 제한했다. 인증 문제의 원인은 키나 비밀번호가 아니라 **파일명**이었다. 복사 과정에서 `authorized_keys` 대신 `authorized\_keys`라는 이름이 만들어졌다. 따옴표 안에서는 밑줄 앞 역슬래시가 실제 파일명에 남을 수 있다. 키 지문·권한·사용자 허용이 모두 맞더라도 SSH는 다른 파일을 읽게 된다. `ls -lb`로 파일명을 확인하고 정확한 이름으로 공개키를 추가한 뒤 접속에 성공했다. 잘못된 파일은 기존 내용을 지우지 않고 보존했다. ## 3. FFmpeg를 앱에 포함한 이유와 구조 Mac에는 FFmpeg와 Homebrew가 없었다. 실행파일만 내려주면 창은 열려도 영상 기능이 실패하므로 Apple Silicon 패키지에 별도 FFmpeg 실행파일을 포함했다. ```text notParsec.app/ Contents/ MacOS/notparsec 통합 사용자 앱 Helpers/ffmpeg 캡처·VideoToolbox 인코딩·CPU 디코딩 Resources/ffmpeg/ 라이선스·정확한 소스·빌드 옵션·출처 Info.plist ``` `NOTPARSEC_FFMPEG`의 절대 경로를 지정하면 그것을 사용한다. 지정하지 않은 Mac 앱은 자신의 `Contents/Helpers/ffmpeg`를 먼저 찾으며, 이후 기존 외부 FFmpeg 경로를 확인한다. `.app` 전체를 응용 프로그램 폴더로 옮겨도 보조 실행파일을 찾는다. FFmpeg 6.1.6 공식 소스의 PGP 서명을 공식 키 지문 `FCF986EA15E6E293A5644F10B4322F04D67658D8`으로 검증하고 SHA-256을 빌드 스크립트에 고정했다. [공식 다운로드·서명 확인](https://ffmpeg.org/download.html)을 따른다. 소스 SHA-256은 `d4fcb164028dd3beee5d92c0ac72e46aac6973c75ea12dc14de07bf8f407370a`다. `scripts/build-macos-ffmpeg.py`는 네이티브 Mac에서 AVFoundation, VideoToolbox H.264/H.265 인코더, H.264/H.265/원시 프레임 디코더, Annex B 필터와 스케일링을 빌드한다. 네트워크 프로토콜은 비활성화하며 파이프·파일만 사용한다. GPL·nonfree 외부 인코더는 포함하지 않았다. FFmpeg 라이브러리를 Rust 실행파일에 링크하지 않고 별도 LGPL 실행파일로 사용하며, 정확한 원본 소스·라이선스·구성 옵션을 앱 안에 함께 보관한다. [FFmpeg 라이선스 안내](https://ffmpeg.org/legal.html). 검증한 소스 아카이브를 준비한 Mac에서 다음 순서로 재현한다. ```sh python3 scripts/build-macos-ffmpeg.py --source-archive /path/to/ffmpeg-6.1.6.tar.xz --output /path/to/ffmpeg-arm64 python3 scripts/build-portable.py --target aarch64-apple-darwin --ffmpeg-bundle /path/to/ffmpeg-arm64 ``` ## 4. 실제 시험에서 수정한 문제 | 발견한 문제 | 처리 | 확인 | |---|---|---| | `lipo -verify_arch` 뒤에 파일명을 두면 파일명을 아키텍처로 해석 | 파일명을 먼저 전달 | 앱·FFmpeg arm64 검사 통과 | | 시작 로그를 앱 실행파일 옆에 써 코드 서명이 깨짐 | Mac 로그를 `~/Library/Logs/notParsec/startup.json`으로 이동 | 실행 후 `codesign --verify --deep --strict` 통과 | | 최소 FFmpeg 빌드가 합성 영상의 `wrapped_avframe`을 해석하지 못함 | 해당 디코더를 포함 | 합성 H.264/H.265 왕복 시험 통과 | | 업데이트 시험이 Mac 임시 경로의 `/private` 별칭과 300ms 시작 시간에 의존 | 시험 경로 정규화, 성공 사례의 대기 상한 조정 | 기존 진단·실패 복원 시험 6개 통과; 제품의 경로 검사와 30초 제한은 유지 | ## 5. 무엇을 검증했나 - 전체 arm64 release 빌드, CLI 버전, 앱·보조 실행파일 서명, 시작 후 서명 보존. - 실제 Mac 화면에 notParsec 창이 표시되고 사용자가 Computers·Settings 화면을 정상 확인. - 생성한 시험 영상 640×480, 30fps를 H.264와 H.265 VideoToolbox로 각각 인코딩. `allow_sw=0`으로 하드웨어 인코더를 사용하고, 앱의 실제 FFmpeg 디코더에서 각각 58개의 유효한 RGBA 프레임을 확인. - 플랫폼 시험 2개, 업데이트·진단 시험 6개, Mac Clippy 경고 없음. 게시기·권한 경계 시험 20개. - 실제 패키지를 Ubuntu 게시기로 검증·설치하고 원본과 설치 파일의 SHA-256이 일치함을 확인. Windows EXE와 `update.json` 해시는 변경되지 않음. 이 영상 시험은 사용자의 실제 화면을 캡처하거나 입력을 주입한 시험이 아니다. 디코딩은 **현재 CPU FFmpeg → RGBA → OpenGL**이며, 하드웨어 디코드·Metal 직접 표시나 Parsec 수준 성능을 검증했다고 표시하지 않는다. ## 6. 설치와 남은 검증 Apple Silicon 패키지를 다운로드하고 압축을 푼 뒤 `notParsec.app`을 응용 프로그램 폴더로 옮겨 실행한다. 이번 빌드 Mac에는 `~/Applications/notParsec.app`으로 설치했다. FFmpeg는 포함돼 있어 별도 설치가 필요 없다. 호스팅에는 화면 기록과 손쉬운 사용 권한이 필요하다. 권한을 우회하지 않으며, 승인·거부·철회와 실제 Windows↔Mac 화면·입력·클립보드는 후속 검증이다. 패키지는 ad-hoc 서명이며 Developer ID·Apple 공증과 다르다. 웹에서 내려받아 격리 속성이 붙은 파일의 Gatekeeper 처리는 이번 로컬 빌드 실행으로 검증되지 않는다. Intel 네이티브 빌드·실기기와 Mac 자동 업데이트도 남아 있다. 원본 기준은 Windows Parsec 150-104a, 코어 SHA-256 `8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f`다. 자체 관리·게시(E02)와 Mac 포트(E05)의 결과이며 Mac Parsec 원본 바이너리·화면·지연과의 일치는 미확인이다. F01/F61/F82의 parity는 `different`를 유지한다. [검증 기록·해시·시험 로그](evidence/mac-native-validation.json) · [Mac 다운로드 경로](MAC_DOWNLOADS.ko.md) · [플랫폼 구조와 남은 차이](CROSS_PLATFORM.ko.md)