✕

파일 전송

개요

데스크톱에서 Spck CLI를 실행하면 데스크톱 파일시스템과 스마트폰에 저장된 로컬 프로젝트 간의 동기화 허브 역할을 합니다. 양쪽이 Spck Editor 파일 관리자에 나란히 표시되며, 스마트폰의 로컬 프로젝트는 왼쪽에, 데스크톱 파일은 연결된 원격 서버로 표시됩니다. 표준 복사/붙여넣기 명령으로 파일이나 폴더 전체를 양방향으로 복사할 수 있습니다.

AirDrop, 블루투스, USB 케이블, 서드파티 클라우드 스토리지가 필요 없습니다. 전송은 WebSocket 연결을 통해 end-to-end 암호화되며, 두 기기가 같은 네트워크에 있을 때는 로컬 Wi-Fi 내에서만 이루어집니다.

작동 방식

CLI는 데스크톱 디렉터리를 Spck Editor 파일 관리자의 원격 서버 프로젝트로 노출합니다. 스마트폰에 저장된 로컬 프로젝트는 앱의 로컬 스토리지에 저장됩니다. Spck Editor는 두 위치를 동등한 프로젝트 위치로 처리하므로, 단일 프로젝트 내에서 작동하는 복사/붙여넣기를 포함한 모든 파일 작업이 프로젝트 간에도 동작합니다.

스마트폰 (로컬 스토리지)       데스크톱 (CLI 경유)
────────────────────────       ─────────────────────
my-project/               ↔   ~/projects/my-project/
  ├── index.html                 ├── index.html
  ├── style.css                  ├── style.css
  └── assets/                    └── assets/
      └── logo.png                   └── logo.png

디렉터리는 재귀적으로 전송됩니다. 내부의 모든 파일이 복사되고, 하위 디렉터리는 대상에 자동으로 생성됩니다.

데스크톱에서 모바일로

오프라인 작업, 모바일 앱만 있는 동료와 프로젝트 공유, 기기에 작업 스냅샷 저장 등 컴퓨터에서 스마트폰으로 파일을 가져올 때 사용합니다.

  1. 전송할 폴더를 지정하여 데스크톱에서 CLI를 시작합니다:

    spck --root ~/projects

  2. 카메라 앱으로 QR 코드를 스캔하고 Spck Editor에서 링크를 열어 스마트폰을 연결합니다.

  3. Spck Editor의 프로젝트 패널에 데스크톱 폴더가 원격 서버 프로젝트로 나타납니다.

  4. 원격 프로젝트에서 원하는 파일 또는 폴더를 길게 누른 다음 복사를 탭합니다.

  5. 스마트폰의 로컬 프로젝트로 이동합니다(새 프로젝트로 새로 만들 수도 있습니다).

  6. 대상 폴더를 길게 누른 다음 붙여넣기를 탭합니다.

파일이 데스크톱에서 다운로드되어 스마트폰의 로컬 스토리지에 저장됩니다.

모바일에서 데스크톱으로

이동 중 편집 후 작업을 다시 데스크톱으로 보내거나, 기기에서 만든 프로젝트를 통합할 때 사용합니다.

  1. 파일을 저장할 폴더를 지정하여 데스크톱에서 CLI를 시작합니다:

    spck --root ~/Desktop/from-phone

  2. QR 코드를 스캔하여 스마트폰을 연결합니다.

  3. Spck Editor에서 보내려는 파일이 있는 스마트폰의 로컬 프로젝트를 엽니다.

  4. 원하는 파일 또는 폴더를 길게 누른 다음 복사를 탭합니다.

  5. 프로젝트 패널에서 원격 데스크톱 프로젝트로 이동합니다.

  6. 대상 폴더를 길게 누른 다음 붙여넣기를 탭합니다.

파일이 스마트폰의 로컬 스토리지에서 읽혀 CLI를 통해 데스크톱에 기록됩니다.

프로젝트 전체 전송

한 번의 붙여넣기 작업으로 전체 프로젝트 폴더를 복사할 수 있습니다. 파일 트리에서 프로젝트 루트를 길게 누르고 복사를 선택한 다음, 대상으로 이동하여 붙여넣기를 탭합니다. 모든 하위 디렉터리의 모든 파일을 포함한 전체 디렉터리 트리가 전송됩니다.

다음 경우에 유용합니다:

  • 대규모 변경 전에 모바일 프로젝트를 데스크톱에 백업하기
  • 기존 데스크톱 코드베이스에서 스마트폰 새 프로젝트 초기화하기
  • 여러 기기의 작업을 한 곳으로 통합하기

팁

파일 크기 제한

기본 최대 파일 크기는 파일당 10 MB입니다. 이미지, 아카이브, 컴파일된 바이너리 등 더 큰 파일을 전송하려면 CLI 구성에서 제한을 늘리세요:

{
  "filesystem": {
    "maxFileSize": "200MB"
  }
}

자세한 내용은 CLI 구성을 참조하세요.

전송 속도

속도는 전적으로 로컬 Wi-Fi 또는 인터넷 연결에 따라 달라집니다. 대용량 디렉터리의 경우 파일별로 전송되므로 전체 처리량은 파일 수에 비례합니다. 일반적인 가정용 Wi-Fi 네트워크에서 텍스트 위주의 소규모 프로젝트(수백 개 파일)는 몇 초 안에 완료됩니다.

보안

모든 전송은 WSS(WebSocket Secure)로 암호화되며, 각 요청은 세션별 시크릿 키로 서명됩니다. 릴레이 서버는 기기 간 메시지를 전달하지만 암호화되지 않은 콘텐츠는 수신하지 않습니다. 자세한 내용은 CLI 보안을 참조하세요.

여러 전송 동시 실행

CLI는 단일 루트 디렉터리를 노출합니다. 여러 위치에서 동시에 전송하려면 별도의 터미널에서 CLI 인스턴스를 각각 실행하세요:

# 터미널 1: ~/projects 노출
spck --root ~/projects

# 터미널 2: ~/Documents 노출
spck --root ~/Documents

각 인스턴스는 고유한 QR 코드와 연결을 생성하며, 두 원격 서버가 Spck Editor 프로젝트 패널에 동시에 나타납니다.