기본 콘텐츠로 건너뛰기

[펌]성공적인 프로젝트를 위한 다국어 리소스 준비- 1

성공적인 프로젝트를 위한 다국어 리소스 준비- 1


1. 다국어 리소스?
국내뿐만 아니라 해외에서도 널리 쓰이는 소프트웨어가 되기 위해서는 주체가 누구든지 로컬라이징(Localizing-이하 '지역화')을 해 주든지 과정이 필요합니다.
이 때 개발자가 만든 프로그램이 이러한 지역화에 준비되어 있지 않으면, 개발자 뿐만 아니라 많은 사람들이 피곤하게 됩니다. (특히, 개발자만 죽어나는 경향이 있습니다.)
그러나, 다국어 리소스에 대한 준비 과정 자체는 상당히 간단하고, 미리 준비만 잘 해놓으면, 오히려 개발자가 일을 분담시킬 수 있습니다.
이 글에서는 어떤 방식으로 다국어 리소스를 준비하는 사용하고지에 대해서 살펴 보도록 하겠습니다.
2. 다국어 리소스 사용 준비
다국어 리소스 사용 준비 과정은 무척 간단합니다.
모든 리소스, 특히 문자열 리소스 사용시에 하드코딩을 없애고, 리소스로 따로 분리하도록 하면 끝입니다. 간단하지만, 다국어 버젼을 위해서는 반드시 꼭 하셔야 하는 일입니다.
예를 들어 보겠습니다.



AfxMessageBox( "Hello, World!" , MB_OK , 0);
AfxMessageBox( IDS_HELLO , MB_OK , 0 );


위의 첫 번째의 경우는 언어가 바뀔 때마다 하드코딩을 해줘야 합니다. 두 번째의 경우는 리소스만 바꿔주면 됩니다.
언어가 바뀔 때마다 하드코딩을 해주는 것과, 리소스만 바꿔주면 되는 것이 결국은 동일한 일이 아니냐고 물어보고 싶으신 분들도 있을 겁니다.
자신 있게 그건 그렇지 않다고 말씀드릴 수 있습니다. 첫 번째의 경우는 언어가 바뀌면 컴파일을 새로 하는 과정이 필요하고, 리소스와 코드가 분리되어 있지 않기 때문에, 다른 사람에게 지역화하는 과정을 분담시킬 수 없습니다.
두 번째의 경우, 나중에 또 다른 글에서 말씀 드리겠지만, 랭귀지 리소스는 따로 빼서 Satellite dll로 만들 수도 있고 (이 때 부분적인 컴파일은 필요합니다.), 지역화를 하는 사람이 반드시 프로그램을 개발한 사람이 할 필요가 없습니다.
그리고, 향후 다른 언어의 추가 시에도 소스 전체를 뒤지지 않아도 되고, 유지 보수 때에도, 백만 스물 두 배는 쉬워집니다.
그리고 첫 번째의 경우도 소스코드를 모두들 다른 사람 혹은 다른 회사에게 넘겨 주면 지역화는 가능하겠지만, 개발사 입장에서는 그런 방식의 지역화를 기뻐할 지는 의문입니다.
특히, 두 번째의 경우 다른 사람에게 일을 분담할 수 있다는 개발자 입장에서는 굉장한 강점입니다. 한국 개발자들 할 일도 많은데, 이런 일은 어학에 능숙한 분들에게 맡기고, 개발자들은 본업에 충실하게 일하는 그런 명랑한 삶을 살아야 하지 않겠습니까?
이 밖에도 성공적인 지역화를 위해서는 몇 가지 원칙이 있습니다. 마이크로 소프트 웹 사이트에 잘 정리된 내용이 있어서, 인용합니다.



지역화 방법
  1. 모든 사용자 인터페이스 요소를 프로그램 원본 코드와 분리합니다. 이 요소를 리소스 파일, 메시지 파일 또는 개별 데이터베이스에 넣습니다.
  2. 프로젝트 수행 중 계속해서 동일한 리소스 식별자를 사용합니다. 식별자를 변경하면 지역화된 리소스를 업데이트하기가 어려워집니다.
  3. 여러 문맥에서 사용되는 경우, 동일한 문자열을 여러 개 만듭니다. 동일한 문자열은 문맥에 따라 다르게 번역될 수 있습니다.
  4. 지역화될 수 없는 문자열은 리소스에 넣지 않고, 원본 코드에 문자열 상수로 그냥 둡니다.
  5. 번역할 때 텍스트 크기가 확장될 수 있으므로 텍스트 버퍼를 동적으로 할당합니다. 정적 버퍼를 사용해야 한다면 지역화된 문자열을 수용할 수 있도록 버퍼의 크기를 더 크게 만듭니다. 즉, 영어 문자열 길이의 두 배로 만듭니다.
  6. 지역화 때문에 대화 상자를 확장해야 할 수도 있다는 것을 유념합니다. 그러므로 저해상도 모드에서 화면 전체를 차지하는 큰 대화 상자는 지역화할 때 여백이 있도록 약간 작은 크기로 수정해야 합니다.
  7. 비트맵 또는 아이콘 안에 텍스트를 사용하지 않습니다. 지역화하기가 어렵기 때문입니다.
  8. 실 행 중 여러 문자열을 연결하거나 정적 텍스트에서 문자를 제거하여 텍스트 메시지를 동적으로 만들지 않습니다. 단어 순서는 언어에 따라 변하므로, 텍스트를 이러한 방식으로 동적 결합할 경우 일부 언어로 지역화할 때 코드를 변경해야 할 수 있습니다.
  9. 마찬가지로 인수 삽입 순서도 일부 언어로 번역될 때 변경될 수 있으므로, 서식 문자열(예: sprintf 또는 wsprintf)에 여러 삽입 매개 변수를 사용하여 텍스트를 구성하지 않습니다.
  10. 아 라비아어 또는 헤브라이어 같은 중동 언어로 지역화한다면, 오른쪽에서 왼쪽으로 향하는 레이아웃 API를 사용하여 응용 프로그램이 오른쪽에서 왼쪽으로 향하도록 합니다. 자세한 내용은 Microsoft Systems Journal 기사를 참조하십시다.
  11. 지 역화된 응용 프로그램을 Windows 2000의 모든 언어 변수에서 테스트합니다. 권장 사항에 따라 응용 프로그램에서 유니코드를 사용할 경우에는 수정 없이 잘 실행되어야 합니다. Windows 코드페이지를 사용할 경우에는 테스트하기 전에 시스템 로케일을 지역화된 응용 프로그램에 적절한 값으로 설정하고 다시 부팅해야 합니다.
출처: http://www.microsoft.com/korea/technet/win2000/glbestp.asp


3. 다국어 리소스 만들기
여기서 Visual Studio에서 언어별로 리소스를 만드는 과정을 보여 드리겠습니다.
Visual Studio에서 간단한 Dialog 기반의 프로젝트를 생성해서, 생성된 다이얼로그 혹은 다른 리소스를 선택하고 마우스 오른 쪽 버튼을 누르면, "Insert Copy" 메뉴가 보입니다.





여기서 아래와 같이 자신이 추가하기를 원하는 리소스를 선택해 주시면 됩니다.

이와 같은 방식으로 선택하면, 아래와 같이 IDD_MULTIRESOURCE_DIALOG의 영문판 리소스가 추가 된 것을 볼 수 있습니다.



이와 같은 과정을 반복해서, 모든 리소스에 대해서 각각 다른 나라 언어를 위한 리소스를 만들어 주고, 그 나라 언어에 맞게끔 지역화를 해주면, 준비는 끝입니다.
여기서 한 가지 주의할 점은, 문자열 리소스와는 달리 다이얼로그 리소스는 해당 환경의 폰트에 따라 윈도우의 크기가 개발자가 생각했던 것과 다르게 나타날 수 있습니다.
배포하기 이전에 반드시 정상적으로 윈도우가 출력이 되는지, 모양은 원래의 설계와 동일한 확인할 필요가 있습니다.
또 하나의 주의점은 각 나라마다 다이얼로그에 쓰이는 기본 폰트 역시 반드시 확인해 야 합니다. 한국의 '굴림' 폰트가 미국에서도 똑같이 '굴림'이라고 인식될 수는 없을 테니 말입니다. 
참고로 말씀 드리면 영문 프로그램의 경우 'MS Sans Serif', 폰트 사이즈는 8을 많이 사용합니다.
4. 다국어 리소스 테스트
위의 내용을 바탕으로 해서 테스트 프로그램을 하나 작성해 보겠습니다.
윈도우 응용 프로그램에서 리소스를 가져올 때 기준이 되는 것은 사용자의 User Interface 기본 언어입니다. 이러한 User Interface 기본 언어는 제어판에서 지역 설정 항목에서 바꿀 수 있습니다.
MFC에서는 이러한 로케일 기본 언어에 따라서, 자동으로 해당 언어에 해당되는 리소스를 불러오게 됩니다.
그리고, 이 리소스를 불러 올 때, 기본 적으로는 관련 함수를 호출한 모듈을 기본으로 해서 검색합니다. 좀 더 자세한 내용은, 이 다음 글에서 리소스만을 따로 분리해서 만드는 Satellite dll을 만드는 과정을 설명하면서 다루겠습니다.
원래대로 라면, 영어와 한국어 이렇게 두 가지 언어 리소스를 준비한 다음, 각각 영어가 기본 언어인 시스템에서, 한국어가 기본 언어인 시스템에서 각각 실행해 봐야 하겠지만, SetThreadLocale함수를 통해서, 쓰레드의 기본 로케일을 변경한 후, 위에서 준비한 언어 리소스가 제대로 불려지는지 확인하겠습니다.



// Check if English or not
if( strCommandLine.Find(_T("english")) >= 0 )
   SetThreadLocale( MAKELCID( MAKELANGID(LANG_ENGLISH , SUBLANG_ENGLISH_US) , SORT_DEFAULT));
else
   SetThreadLocale( MAKELCID( MAKELANGID(LANG_KOREAN , SUBLANG_KOREAN) , SORT_DEFAULT));
 


위와 같은 식으로 영문과 한글로 각각 기본 언어를 바꾸고, 실행한 결과는 아래와 같습니다.


다국어 버젼의 리소스들이 훌륭하게 동작하고 있는 것을 확인할 수 있습니다.
5. 결론
이상으로 오늘의 글은 끝을 맺기로 하겠습니다.
간략하게 정리를 해보자면, 성공적인 프로젝트의 지역화를 위해서는, 소스와 리소스를 분리하는 작업이 필요하며, 이것은 소스 코드 개발 시부터, 개발자가 염두에 두고 작업을 해야 합니다.
또, 이 글에서는 Visual Studio에서 어떤 방식으로 다국어 리소스를 추가할 수 있는 지를 살펴 보았습니다.
다음 글에서는 리소스의 분리와 이를 이용한 Satellite dll을 만드는 방법, 그리고 프로젝트에서 이를 이용하는 방법에 대해서 살펴 보기로 하겠습니다.




데프비아 - 석재헌

댓글

이 블로그의 인기 게시물

80040154 오류로 인해 CLSID가 {xxxx-...}인 구성 요소의 COM 클래스 팩터리를 검색하지 못했습니다.

원문보기 .NET 으로 만든 응용프로그램에서 com 객체를 호출한 경우 Windows7 64bit 에서 제목과 같은 에러가 발생했다. Win32 COM 과 .NET 프로그램간의 호환성 때문에 생긴 문제였다. 원인은 .NET 실행시 JIT 컴파일러에 의해 최적화된 기계어로 변환되기 때문.. Win32 COM은 컴파일시.. Win32 COM에 맞춰 빌드 속성에서 하위버전으로 맞춰 컴파일을 다시하는 방법도 있지만 메인 프로젝트가 .NET이라면 참조되는 모든 프로젝트를 다 바꿔야할 노릇.. 또 다른 방법은 COM+를 이용하여 독립적으로 만드는 것이다. 분리시키는 방법은 아래 주소해서 확인할 수 있다. http://support.microsoft.com/kb/281335 나의 경우는 Win32 COM DLL을 64비트 .NET 프로그램에서 참조하니 COM 객체를 제대로 호출하지 못하였습니다. 그래서 .NET 프로그램의 Target Machine을 x86으로 설정하니 제대로 COM 객체를 호출하였습니다.

[Pyinstaller] 실행 파일 관리자 권한 획득하기

고객사에서 일부 사용자에게서 프로그램 오류가 발생한다며 아래와 같이 에러 캡처를 보내왔습니다. 프로그램에서 로그를 남기기 위해 로그 파일을 생성하는데 권한의 문제로 로그 파일을 생성하지 못해 프로그램 오류가 발생한 것 같습니다. 처음에는 Python 코드에서 관리자 권한을 요청하는 코드를 넣으려고 했는데, 실제로 Stackoverflow를 찾아보면 이런 내용이 나옵니다. 프로그램이 관리자 권한으로 실행되지 않았다면 관리자 권한으로 다시 프로그램을 실행시키는 코드입니다. import os import sys import win32com.shell.shell as shell ASADMIN = 'asadmin' if sys.argv[-1] != ASADMIN: script = os.path.abspath(sys.argv[0]) params = ' '.join([script] + sys.argv[1:] + [ASADMIN]) shell.ShellExecuteEx(lpVerb='runas', lpFile=sys.executable, lpParameters=params) sys.exit(0) 하지만 개인적으로 이런 방식은 마음에 들지 않았고 조금 더 찾아보니 Pyinstaller로 exe 파일을 만들 때 옵션을 설정하여 관리자 권한을 요청하도록 할 수 있다고 합니다. --uac-admin을 옵션에 추가하면 프로그램 실행 시 관리자 권한을 요청할 수 있습니다. pyinstaller.exe --uac-admin sample.py 하지만 안타깝게도 이 방식은 원하는 대로 동작하지 않았습니다. 마지막으로 manifest 파일을 이용하여 시도해보았습니다. spec 파일을 이용하여 pyinstaller로 빌드하면 <실행 파일 이름>.manifest 라는 파일이 생성됩니다. 파일에서 아랫부분을 찾아볼 수 있습니다. <security> <re

초간단 프로그램 락 걸기

프로그램에 락을 걸 일이 생겨났다. 하드웨어 락을 걸면 쉬울텐데 그 정도는 아니고 프로그램의 실행 날짜를 제한 해 달라고 한다. 그래서 파일(license.lic)을 가지고 락을 걸리고 결정을 했다. 요구 사항은 아래와 같다. 1. license.lic 파일이 없으면 프로그램을 실행 할수 없게 한다. 2. 지정한 날짜를 넘어서는 프로그램을 실행 할수 없게 한다. 3. 사용자가 시스템 날짜를 되돌렸을때 인식하여 프로그램을 실행 할수 없게 한다. 음.... 1.번 문제는 사용자가 프로그램을 실행하기 위해서 license.lic 파일을 받아야만 한다. license.lic 파일에는 최근 실행 날짜/종료날짜 이런식으로 적도록 한다.(물론 내용은 암호화 한다.) 최근 실행날짜는 프로그램이 실행때마다 업데이트 하도록 하고 시스템 날짜와 비교하여 시스템 날짜가 최근 실행 날짜보다 이전의 날짜면 시스템 날짜를 되돌렸다고 인식하도록 한다.(3.번 문제 해결) 시스템 날짜와 종료 날짜를 비교하여 시스템 날짜가 종료 날짜를 넘으면 프로그램을 실행 할수 없도록 한다.(2.번 문제 해결)