본문으로 건너뛰기

공유 (share)

🔔 최신화 일자: 2025-06-12

개요​

share 네임스페이스는 네이티브 공유 UI를 통해 콘텐츠를 공유하는 기능을 제공합니다.

공유하기 기능은 웹, Android, iOS 플랫폼 모두에서 사용 가능합니다.

🚨 주의
카카오톡 공유 관련 기능은 nachocode SDK v1.5.0부터 kakao 네임스페이스로 이동되었습니다.
따라서 share.sendKakao, share.KakaoShareType 등은 더 이상 사용을 권장하지 않습니다.
➡️ kakao 네임스페이스로 이동된 공유 기능 문서 보기

메서드 목록​

메서드설명추가된 버전변경된 버전
openSharing(shareData)네이티브 공유 UI를 열어 콘텐츠를 공유합니다.ver.1.1.0ver.1.6.0

메서드 상세​

openSharing(shareData: { title?: string; url: string; text?: string } | { title?: string; url?: string; text: string }): void​

  • since ver.1.1.0
  • lastupdated ver.1.6.0

설명 (openSharing)​

공유할 데이터를 받아 네이티브 공유 API를 호출합니다.

네이티브 공유 UI는 기본적으로 사용자의 디바이스에 설치된 공유 가능한 앱 목록을 표시합니다.

웹 공유 API와 동일한 구조의 { title, url, text } 형식을 지원합니다.

참고 : MDN - Navigator: share( ) method

지원 플랫폼 (openSharing)​

openSharing 메서드는 App과 Web 환경을 동시 지원합니다.

  • ✅ Web
  • ✅ Android
  • ✅ iOS

매개변수 (openSharing)​

⚠️ 주의
nachocode SDK v1.6.0부터는 object 형식(title, url, text를 조합)으로 매개변수가 변경되었으며,
기존 단일 url 전달 방식은 Deprecated 되었습니다.

shareData는 반드시 url 또는 text 중 최소 1개 이상을 포함해야 합니다.

이름타입필수 여부설명
shareData.titlestring❌공유할 대상 제목
shareData.urlstring조건부공유할 대상 URL
shareData.textstring조건부공유할 대상 텍스트

반환 값 (openSharing)​

해당 메서드는 반환 값을 가지지 않습니다.

사용 예제 (openSharing)​

// URL 공유 - 공유할 URL을 지정하여 네이티브 공유 UI를 엽니다.
Nachocode.share.openSharing({
  url: 'https://developer.nachocode.io/docs/sdk/releases/v1/intro',
});
// 텍스트 공유 - 공유할 텍스트를 지정하여 네이티브 공유 UI를 엽니다.
Nachocode.share.openSharing({
  text: '최신 SDK 업데이트 소식을 확인해보세요!',
});
// `title`, `url`, `text` 전부 활용 예시
Nachocode.share.openSharing({
  title: '나쵸코드 최신 업데이트',
  url: 'https://developer.nachocode.io/docs/sdk/releases/v1/intro',
  text: '최신 SDK 업데이트 소식을 확인해보세요!',
});

추가 정보​

  • share 네임스페이스는 일반 콘텐츠 공유(openSharing) 전용으로 유지됩니다.
  • 카카오톡 공유 기능은 앞으로 kakao 네임스페이스를 통해 사용해야 합니다.