삼성 모바일 확장 프로그램 변환 프로젝트 SIX Bridge 0.1.1 배포

깃헙에 공개 배포 됐습니다
이건 셀프 호스팅 프로젝트가 아니라서 딱히 가이드라고 할 건 없습니다만

우선 데스크탑 앱은 맥OS 버전만 있습니다
사실 크게 쓸 일은 없을 겁니다
폰에서 안되는 건 데스크탑으로 해도 안될 확률이 높은 확장 프로그램이거든요
사용법은 주소나 확장 프로그램을 넣고 분석을 하면
삼성 모바일 인터넷 브라우저용으로 변환 가능한지 확인 가능 합니다

Video Download to NAS - Chrome 웹 스토어
VDtN 확장 프로그램으로 테스트를 해보면


분석 결과가 금방 나옵니다
간단한 확장이거든요



다음 다음 누르고 SixDraft 저장을 하시면 됩니다


완료 후에 파일 위치 열기 하시면 sixdraft 파일이 저장 된 게 보입니다
이 파일을 폰으로 옮겨서 apk 앱을 통해 설치 하시면 됩니다만
폰에서 직접 변환하는 게 더 편하겠죠?

모바일 앱을 설치하고 실행하면 이런 화면이 보입니다
스토어가 아닌 외부 배포 앱이라서
앱 설치 할 때 보안 경고가 뜰 수 있습니다
플레이 프로텍트에 인증 등록을 하긴 했는데 출처 문제는 어쩔 수가 없네요
무시하고 설치 하시면 되고 찝찝하신 분들은 직접 빌드해서 사용하세요
메뉴는 간단하게 네 가지가 있습니다
하단에는 설치한 확장들이 보이고요
간단히 동작 방식을 설명하면
Chrome 웹 스토어의 확장 프로그램을 분석해 Chromium 확장과
Samsung Internet 사이의 API, Manifest, 모바일 동작 차이를 확인합니다
그중 동작 의미를 안전하게 유지할 수 있는 부분에는 호환 어댑터를 적용합니다
모든 확장이 자동 변환되는 것은 아니며 지원할 수 없거나 확인되지 않은 기능이 있으면
변환 또는 설치가 제한될 수 있습니다.
Android에서는 변환된 확장 본체를 확장별 래퍼 APK에 넣고
기기의 Android Keystore에서 생성한 로컬 키로 서명합니다
이 래퍼 APK를 설치하면 Samsung Internet의 추가 기능으로 인식됩니다
설치 후 실제 활성화 여부는 Samsung Internet의 추가 기능 화면에서 별도로 확인하거나 설정해야 합니다
SIX Bridge 관리자 앱의 메인 목록은 Samsung Internet에서 확장이 활성화됐는지를 나타내는 것이 아니라
확장 래퍼 APK가 Android에 설치돼 있는지를 보여줍니다
.sixdraft는 데스크톱에서 분석한 결과를 Android로 전달해 다시 검증·변환하기 위한 초안 파일입니다.six는 변환된 CRX3, 래퍼 APK와 호환성 정보를 함께 담아 보관하거나 다시 가져올 수 있는 번들 파일입니다.
참고로 변환 결과는 원본 확장 제작자의 공식 배포본이 아니며
사용자는 해당 확장을 변환·설치할 권한과 라이선스를 직접 확인 해야 합니다
변환된 파일 공유는 저작권 문제가 생길 수 있으니
본인이 만든 확장 프로그램을 변환하는데만 사용하시길 바랍니다
이 기기에서 변환은 데스크탑 앱의 기능처럼 주소나 파일을 넣고 변환을 시작하는 기능입니다
데스크탑 변환 파일 가져오기는 데스크탑에서 만든 .sixdraft 파일을 통해 설치 하는 기능이고요
변환된 six 파일 설치는 모바일에서 변환한 .six 파일을 통해 설치하는 기능입니다
삼성 애드온 열기는 삼성 브라우저의 추가기능 탭을 열어주는 겁니다
기능은 간단하죠
직접 변환 방법은 데스크탑 앱과 다르지 않기 때문에 생략하고

데스크탑에서 가져오기를 통해 .sixdraft 파일을 불러왔습니다
잠시 검증 후에


데스크탑 앱에서도 봤던 검증 결과가 표시 됩니다
.six 생성을 누르면 변환이 진행 되고 설치 apk 내보내기와 파일로 저장 메뉴가 표시 됩니다
apk 내보내기를 하면 설치 가능한 apk로 저장되고
파일로 저장을 하면 .six 파일로 저장이 됩니다
공유는 .six 파일을 공유 하는 기능이고요

apk로 내보내기 하면 파일 앱 열기 버튼이 표시 됩니다
파일 앱 열기를 누르면 안드로이드 기본 탐색기가 실행 되고요
거기서 내보낸 apk를 선택해서 설치 하시면 됩니다
참고로 안드로이드 기본 탐색기나
갤럭시 내 파일 앱이 아닌 서드파티 앱의 경우
apk 설치시 설치된 확장이 동작 안할 수 있습니다
apk파일을 설치하면서 패키징 서명 정보를 수정하기 때문인데요
안드로이드나 갤럭시 순정 탐색기로 설치하시길 바랍니다

SIX 브릿지 앱에서 만든 apk기 때문에 이런 경고가 뜹니다
무시하고 설치 하시면 됩니다

그러면 이런 화면이 뜨거나 그냥 설치가 될 겁니다
이런 화면이 뜨면 앱 검사 해주세요
안전한 앱이라고 표시 될 겁니다

설치 후에 삼성 모바일 브라우저 우측 하단을 보면 빨간 점이 표시 될 겁니다
메뉴 열고 추가 기능 탭으로 가시면

이렇게 새로 설치 된 확장이 보이실 겁니다
저는 이것저것 테스트 하느라 뭐가 많은데 아마 텅 비어 있을 겁니다

설치 한 확장 프로그램을 들어가 보시면 추가 기능 설정이 있습니다
크롬 확장 옵션 과 같은 메뉴 입니다

눌러 보시면 이런 옵션 창을 확인 할 수 있습니다

그 후에는 이렇게 더 보기 메뉴나 툴바에 추가해서 사용 하시면 됩니다
확장 프로그램에 따라 영상이나 이미지를 꾹 누른다거나 링크를 꾹 누른다거나 하는 동작을 할 때
삼성 모바일 브라우저 컨텍스트 메뉴에 선택 가능한 확장 메뉴가 표시 되기도 합니다

이런 식으로요


그리고 더보기 메뉴나 툴바에 확장 프로그램을 추가하는 방법은
브라우저 설정 - 레이아웃 및 메뉴 - 옵션 더보기 메뉴, 툴바
에서 설정 하시면 됩니다

이렇게 선택 할 수 있거든요
솔직히 별 내용 아닌데 스샷을 일일이 첨부 하다보니 글이 길어졌네요
주의 하실 부분은 파일 공유시 저작권 문제 조심하시고요
테스트 환경은 삼성 z폴드7에서 실기기 테스트를 했기 때문에
다른 기기들은 검증이 안됐습니다
설계상으로는 갤럭시가 아닌 안드로이드 폰에서도 삼성 브라우저 설치 후 사용이 가능해야 하는데
아직 테스트를 못해 봤네요
깃헙 계정 있으신 분들은 도움이 됐다 싶으시면 깃헙 스타 라도 한 번 눌러주시면 감사하겠습니다
문제가 있거나 궁금한 점 있으시면 피드백 주시고요
솔직히 공개한 프로젝트들이 다운로드가 수백 수천번 되는데
댓글이나 별이나 추천 같은 별다른 피드백도 없고하면
문제가 있는 건지 없는 건지 알 수가 없기 때문에
굳이 공개 할 필요 있나? 그냥 혼자 써야하나? 라는 생각도 들고
괜히 필요한 사람도 없는데 자꾸 글 올리는 건가 싶기도 하고 뭐 그렇습니다
긴 글 읽으시느라 고생 하셨습니다