2015년 6월 9일 화요일

node.js + add-on c, c++

** node.js
- v8기반으로 동작하는 플랫폼.
- 자바스크립트 기반 언어
- 설치 (ubuntu 12.04기준)

 apt-get install nodejs
 apt-get install npm

** add-on
- c, c++ library(*.so파일들..)를 사용하기 위한 오브젝트
- node-gyp 설치 필요
- 설치 (ubuntu 12.04기준)

npm install -g mode-gyp
(python 2.7, make, c compiler like gcc설치 필요)


**add-on 예제

1. js file (test.js)
var binding = require('./build/Release/binding');
var timeVal = binding.time();
var loginVal = binding.login();

var http = require("http");
var server = http.createServer(function(request, response) {
  response.writeHead(200, {"Content-Type": "text/html"});
  response.write("<!DOCTYPE /html>");
  response.write("<html>");
  response.write("<head>");
  response.write("<title>Hello World Page</title>");
  response.write("</head>");
  response.write("<body>");
  response.write(timeVal);
  response.write(loginVal);
  response.write("</body>");
  response.write("</html>");
  response.end();
});
server.listen(8080, 'localhost');
console.log('binding.timeVal() =', timeVal);
console.log('binding.loginVal() =', loginVal);

2. binding.gyp - json타입이며, binding lib세팅, target_name이 library name
{
  "targets": [
    {
      "target_name": "binding",
      "sources": [ "binding.cpp" ]
    }
  ]
}

3. binding.cpp
#include <node.h>
#include <v8.h>


#include <time.h>
#include <stdio.h>

#include <unistd.h>
using namespace v8;

void getTime(const FunctionCallbackInfo<Value>& args) {
  Isolate* isolate = Isolate::GetCurrent();
  HandleScope scope(isolate);

  time_t   current_time;

  time( &current_time);
 
  args.GetReturnValue().Set(String::NewFromUtf8(isolate, ctime( &current_time)));
}

void getLogin(const FunctionCallbackInfo<Value>& args) {
  int i = 0;
  char cBuf[256];
 
   Isolate* isolate = Isolate::GetCurrent();
   HandleScope scope(isolate);
 
 
  int j = sprintf(cBuf, "%s", getlogin());

  args.GetReturnValue().Set(String::NewFromUtf8(isolate, cBuf));
}


void init(Handle<Object> target) {
  NODE_SET_METHOD(target, "time", getTime);
  NODE_SET_METHOD(target, "login", getLogin);
}

NODE_MODULE(binding, init);

**build
$node-gyp configure build

**execute
$node test.js

**결과 화면


**sample code svn rep.
https://121.134.202.97/svn/Dev3/SRC/trunk/nodejs_addontest


2015년 4월 21일 화요일

Gradle 고찰 - Part.1

1. 배경

어느 날인가, 갑자기 개발환경을 최신화 해야 겠다는 생각이 들어서, Android ADT를 기동하고 SDK을 업데이트 하였으나, 예상대로 매끄럽게 업데이트가 되지 않았다. 그래서 Android 개발자 페이지(https://developer.android.com/index.html)에 가서 ADT를 받으려고 하였으나... 어디에도 찾아 볼 수 없고, 그 자리에 정식 버전으로 릴리스된 Android Studio 가 차지하고 있었다. (헉!! 그래도 현재 Eclipse Plug-in을 통해서 동일한 방식으로 빌드는 할 수 있다.) 
새로운 환경으로 옮겨가기로 맘도 먹었으니 가벼운 마음으로 Android Studio를 설치 하고 기존으로 프로젝트를 임포트 하였으나...빌드가 되지 않는 것이다. 그때 부터 약 30분 간 구글링을 한 결과 빌드 방법이 바뀌었기 때문에 Converting을 해야 만 한다는 사실을 깨달았다. 
그 빌드 방법이 바로 "Gradle"(http://gradle.org)!!!! 이 녀석이 뭐길래 구글의 Android 빌드로 선택 되었나 궁금하여 이 녀석을 고찰 하기로 한다. 

2. Gradle 개요

OPEN SOURCE BUILD AUTOMATION
From command line to IDE to continuous integration, only one Enterprise build automation system to rule them all. Declare and execute all tasks necessary to compile, test, package and ship multi-language multi-platform multi-project and multi-channel software, SaaS and Mobile Apps.


홈페이지에 들어가면 위와 같은 문구를 가장 먼저 볼수 있다. 굳이 직역하자면 

오픈소스 빌드 자동화로서 CLI(Command Line Interface) 부터 IDE(e.g Eclipse, Intelli J....)까지 지원 하는 함. 컴파일, 테스트, 패키지,다양한 언어, 플랫폼, 프로젝트 그리고 SaaS, 모바일 App 등의 다양한 채널로 배포(Ship)을 정의 하고 실행 함. 
(다수의 오역이 있을 수도 있습니다. 지적해주세요)

위와 같다.

흠 그냥 느낌은 뭐 이런 아이들은 많잖아 기존 Ant(http://ant.apache.org)나 Maven(https://maven.apache.org)도 있는데 왜 Android Studio는 Gradle을 공식 빌드로 수용 하였을까? 라는 느낌이다.

https://gradle.org/why/polyglot-builds/#av_section_2 의 "Android's Build System" 부분을 참조하면 의존성 관리, 여러 프로젝트를 통합하여서 빌드해야 하는 경우에 대하여 손쉽게 구성할 수 있는 장점이 있다고 한다.
개인적으로 느낄때는, 기존에는 Ant를 사용하거나 혹은 그냥 Plug-in 에 내장되어 있는 Build를 사용하여도 크게 문제는 없었던 것 같은데 좀 더 명확하게 관리 할수 있게 된것이 장점으로 생각된다. 
오~! 그리고 Signing도 한큐에 어러가지로 할 수 있는 것 같다.(이 부분은 좀 좋은 것 같다~!)

* Gradle?!Groovy??

Gradle은 기본적으로 XML이 아닌 Groovy(http://www.groovy-lang.org) Syntax 로 기술한다.
XML 대비 장점은 다음의 글을 참조 하기 바란다. 

내가 생각하는 Maven의 가장 큰 문제점은 두가지이다.
  • 프로젝트 구성/빌드 툴로써 프로젝트 구성은 정적인 설정 정보이고 빌드는 동적인 행위이다. 그런데 이것을 정적인 데이터를 저장하는데 적합한 XML로 그 내용을 기술하게 함으로써 동적인 행위인 빌드에 크나큰 제약을 가한다. 게다가 XML은 너무 장황해서 실제 설정 내용보다 XML 뼈대가 더 많다.
  • 다른 하나는 Gradle을 사용하다 느낀 것인데, Maven은 설계상의 문제도 있다. 바로 멀티 프로젝트 구성을 상속 구조로 한 점이다. 그에 반해 Gradle은 구성 주입 방식(Configuration Injection, 설정 주입 방식이 더 나은 번역일까?)을 사용한다. 이는 빌드 구성 정보에서 매우 큰 차이를 만든다.
Gradle은 Groovy DSL로 작성하며, 설정 정보는 변수에 값을 넣는 형태로, 동적인 빌드는 Groovy 스크립트로 Gradle용 플러그인을 호출하거나 직접 코드를 짜면 된다.

요컨데 심플하고 환경에 따라 동적으로 빌드 할 수 있는 장점인것으로...

이상 Gradle이 어떤 것인가 대하여 대략 적으로 살펴보았다. 이후 Android의 빌드를 중심으로 Gradle 활용에 대하여 정리하고자 한다. 

to be Continued....

PS. 잘못된 내용이나 문제가 발생할 수 있는 내용은 지적 부탁드립니다.

2015년 4월 17일 금요일

다국어 리소스 파일 생성 툴

오늘 포스팅할 내용은 다국어 파일 생성기입니다.
안드로이드, iOS 두 OS에 대한 다국어 파일을 생성해주며 구글 스프레드시트를 이용하기 때문에 키, 스트링에 대한 관리면에서도 효율적으로 활용할 수 있는 툴입니다.



1. 스프레드시트 작성법
첫번째 열은 KEY와 언어 코드를 작성합니다. 언어 코드는 ISO 639-1에 정의된 값으로 작성합니다.
첫번째 행은 KEY값들을 나열하고 다른 행은 해당 언어의 값을 입력합니다.
** 구글 스프레드시트 팁!!
GOOGLETRANSLATE 함수를 사용하여 쉽게 번역할 수 있다.


2. 공유 설정
생성기를 사용하기 위해서는 공유 설정을 통해 접근 권한을 주어야합니다.
① 접근 공유 설정
- 우측 상단 공유 -> 고급 -> 변경 -> 링크가 있는 모든 사용자 선택

② 웹에 게시
- 파일 -> 웹에 게시 -> 게시 선택
- 게시 후 URL을 복사


3. 리소스 파일 생성
iOS / Android Language Files Maker 사이트 접속.
② URL 입력 및 Make Language Files 버튼 클릭.
- URL은 스프레드시트를 웹에 게시할 때 생성되는 URL을 입력

③ zip파일 다운로드



좀 더 자세한 사용 설명은 아래 동영상을 참고하시기 바랍니다.


2015년 4월 1일 수요일

[HTML5]canvas 데이터 처리


  • 개요
    • 본 문서는 HTML 태그 요소 중 하나인 <canvas>의 데이터 핸들링에 대한 간략한 소개 문서이다.
    • canvas에 그러진 이미지 정보의 추출과 추출된 데이터를 통해 다시 canvas 이미지로의 변환을 소개한다.
    • 추출/변환되는 데이터는 text기반의 타입이다.
  • 예제 소개(기존 단말 샘플 예제)
    1. 이전에 저장된 데이터가 존재하며, 그 데이터를 다시 로드하겠는지 여부 확인


    2. 저장된(단말의 Preference에 저장된) 데이터를 canvas에 로딩.


  • 소드 코드 소개
    1. canvas 이미지를 text기반의 데이터로 저장
      [html]
      <canvas id="canvasSignature" width="200px" height="100px" style="border:1px solid #000000; margin:5px"/>

      [js]
      var sigCanvas = document.getElementById("canvasSignature");
      sigCanvas.toDataURL();

      [sigCanvas.toDataURL(); 결과값]

    2. 저장된 text기반의 데이터를 canvas로 load
      Image 객체를 생성한 뒤, drawImage()

      var context = sigCanvas.getContext("2d");
      var image = new Image();
      image.src = eachdata.value;
      image.onload = function(){
      context.drawImage(image, 0, 0);
      }
  • 브라우저 테스트
    : 위 샘플코드를 일부 수정하여 캔버스 복사 기능을 pc브라우저에서 테스트 함.
    좌측의 기존 캔버스에 드로잉 입력 후, '회원가입'버튼을 클릭하면 오른쪽 캔버스에 동일한 이미지가 복사되도록 테스트
    • 동작 개념 : 좌측 캔버스 드로잉 -> '회원가입' 버튼 클릭 -> 좌측 캔버스에서 base64기반의 텍스트 데이터 추출 -> 오른쪽 캔버스에 해당 텍스트 데이터를 Image객체로 드로잉
    • 사파리 테스트 결과(버전 7.1.4(9537.85.13.7))
    • IE(11.0.17)

2015년 2월 17일 화요일

ACRA Essential

Crash Logger 관련 사용부분에 대하여 기존 정리된 문서가 있어서 공유합니다.

작성자: 전두일/서미정
  1. 개요



본 문서는 Android Application Crash Report Library ACRA(Application Crash Report for Android) 사용법에 대하여 설명하고자 작성한다.
[ ACRA Github에 설명이 잘 되어있어 실사용 관점에서 설명하고자한다. ]


  1. ACRA



ACRA 는 안드로이드 Application의 Crash 를 자동으로 보고해 주는 오픈소스 MIT  License의 라이브러리입니다.
(최초 Google Form 과 연동으로 작성되었으나 구글Docs 부하문제로 사용불가하게됨)



  1. ACRA 사용법 (Device)



    1. Android 설정방법



  1. 라이브러리 등록



  • Maven dependency
<dependency>
 <groupId>ch.acra</groupId>
 <artifactId>acra</artifactId>
 <version>4.5.0</version>
</dependency>


  • Gradle
dependencies {
   ...
   compile 'ch.acra:acra:4.5.0'
}


  • jar include
 Application Project add acra-4.5.0.jar


  1. Android Manifest.xml 수정

<manifest ...>
 <application ... android:name="MyApplication"> ⇐  3.Code 수정 에서 Override한 Application  
   ...
 </application>
 <uses-permission android:name="android.permission.INTERNET"> ⇐ Add Code  
 </uses-permission>
</manifest>


  1. Code 수정 : Application Override

import org.acra.*;
import org.acra.annotation.*;
@ReportsCrashes(
       formKey = "",
       formUri = "http://192.168.0.35:5984/crashlog",
       reportType = org.acra.sender.HttpSender.Type.JSON,
       httpMethod = org.acra.sender.HttpSender.Method.POST
       )                       ⇐ Add Code   3.2. ReportsCrash params  설명
public class MyApplication extends Application {
 @Override
 public void onCreate() {

   ACRA.init(this);  ⇐ Add Code
   super.onCreate();  
 }
}

    1. ReportCrash params

  • User interface

    • mode : 크래쉬발생시 UI
  • ReportingInteractionMode.SLENT
  • ReportingInteractionMode.NOTIFICATION
  • ReportingInteractionMode.TOAST
  • ReportingInteractionMode.DIALOG
*각 모드에 따라 추가되는  params  있음  ex( resDialogText/ resDialogIcon …)
[Toast/ Notification/ Dialog]


    • forceCloseDialogAfterToast : Crash Dialog 보여주기 여부
  • false
  • true : [Force Close] Dialog Show


  • Report Destination

    • formKey : 현재 사용하지는 않지만( GoogleDoc Form ID) 필수 입력항목 [“”]
    • mailTo : 크래쉬 내용이 Mail Intent로 실행됨
    • formUri : 크래쉬 데이터 전송할 Custom Server Uri
    • formUriBasicAuthLogin : 보낼 서버의 로그인 아이디
    • formUriBasicAuthPassword : 보낼 서버 로그인 패스워드
    • httpMethod : 데이터 전송 유형
  • org.acra.sender.HttpSender.Method.POST
  • org.acra.sender.HttpSender.Method.PUT
    • reportType : 데이터 전송 타입
  • org.acra.sender.HttpSender.Type.FORM
  • org.acra.sender.HttpSender.Type.JSON
* 그외  OwnSender 로 Interface를 만들어 사용하는 경우 도 있음
(3.3 OwnServer 에서 추가설명)


  • Report Contents

    • customReportContent : Report 항목을 설정 할 수 있음
5.1 ReportContent 참고
    • additionalSharedPreferences : SharedPreference정보 연동
    • sharedPreferencesName : Acra 설정값의 SharedPreferrnces의 Name 설정
  • arc.* 로 설정정보 get/set
acra.enable/ acra.disable : acra 사용여부
acra.syslog.enable : syslog 보내기여부
acra.deviceid.enable : deviceid 사용여부
acra.user.email : set send user email
acra.alwaysaccept : 보내기설정의 묻는창에서 항상  YES처리
… 소스코드 참고
    • includeDropBoxSystemTags : DropBoxManager 사용여부
  • false
  • true : 그외 참고
  • 설정

    • sharedPreferencesMode : Acra 설정값의 SharedPreferrnces의 Mode 설정
  • Context.MODE_PRIVATE
  • Context.MODE_WORLD_WRITEABLE
  • Context.MODE_WORLD_READABLE
    • sendReportsInDevMode: Signed application package 만 전송됨
  • true / false
    • deleteUnapprovedReportsOnApplicationStart
    • deleteOldUnsentReportsOnApplicationStart
    • connectionTimeout
    • socketTimeout
    • maxNumberOfRequestRetries
    • disableSSLCertValidation


  • Dynamic Configuration

: Configuration을 code 로수정가능 (v4.3)


import org.acra.ACRA;

...
ACRA.getConfig().setHttpMethod(org.acra.sender.HttpSender.Method.POST);
...


    1. Send exception

: catch 된 exception보내기


try {
serverPort = Integer.parseInt("a");
 }
catch (NumberFormatException e) {
ACRA.getErrorReporter().handleSilentException(e);
}
* handleException()  Toast/Dlg/Notification 있음


    1. OwnSender

: Sender를 생성하여 사용
public class OwnSender implements ReportSender {

public OwnSender()
{
}
@Override
public void send(CrashReportData arg0) throws ReportSenderException {
// TODO Auto-generated method stub
Log.d("OwnSender","STACK_TRACE:" + arg0.getProperty(ReportField.STACK_TRACE) );
}
}


    1. 추가 라이브러리

      1. ANR

: [ANR-WatchDog] 추가 라이브러리로 주기적 모니터링을 통해 ACRA 로 보고할수 있다


      1. Native Code error (JNI C/ C++)

:  [Native-Crash-Handler] 추가 라이브러리로 Native Code의 error를 ACRA 로 보고할수 있다.


  1. ACRA 사용법 (Server)

    1. CouchDB

ACRA연동 소개 페이지에서는 iriscouch.com의 ‘cloud couchDB’를 통한 연동을 소개한다.
 하지만 가격 정책이 있고 향후 확장성을 고려하여 이를 배제하고, 일반 couchDB에 구성을 하여 동일하게 동작하도록 구성한다.
      1. CouchDB 설치

      1. CouchDB 구성

  • DB 생성(ex. crashlog db 생성) : admin > ‘create Database’ 클릭
  • Restful API 배포
    couchDB는 Restful API를 기본 기능으로 제공한다.
    위 예제와 같이 crashlog로 DB를 구성한 경우 아래와 같이 클라이언트에 API를 배하면 된다.
    http://192.168.0.35:5984/crashlog
  • DB 내용 확인
    futon admin에서 ‘crashlog’ DB를 클릭하면, 클라이언트에서 전송된 crashlog를 확인 할수 있다.

<그림. DB에 저장된 데이터(2건)>
<그림. 데이터 상세 내역>
      1. 데이터 분석
        https://github.com/ACRA/acralyzer/wiki/manual-setup
        위 setup 가이드를 통해 4.3 viewer 구성 가능
        하지만 커스터마이징을 위해서 관련 라이브러리/소스 분석 작업이 필요하다.
        <그림. iriscouch 연동을 통한 분석 결과 화면>


acralyzer를 이용하지 않고 couchDB의 데이터를 직접 추출하여 화면을 구성하는 방법도 가능하다.
* 참고사항
acra lib에 의해 생성된 json-body에 포함된 crash발생 시각은 단말 기준 시간이다.
    1. R-DBMS

저장 DB(couchDB, R-DBMS)의 종류에 상관없이 연동 규격은 동일하게 구성할 것을 추천한다.
단말은 서버의 DB종류에 상관없이 crashlog수집 및 전송을 위해 acra lib을 사용한다.
서버는 동일한 연동 규격(4.1 couchDB에 소개된 restful API)을 제공한다.


단말로부터 전달받는 정보는 http post방식의 json data이므로
R-DBMS구성을 json data규격을 고려하여 구성할 것을 추천한다.
(acra lib에서 추출되는 json data를 모두 전송할 것인지는 논의 필요)


HTTP연동방식, DB구성, JSON 파싱 등에 제약사항은 없으며, 일반적인 웹 프로젝트 구성에 준해서 진행하도록 한다.


    1. Viewer



  1. 맺음

    1. Report Contents

: 내용이 방대하여 필요부분만 뽑아 전송
ANDROID_VERSION
APP_VERSION_CODE
APP_VERSION_NAME
APPLICATION_LOG
AVAILABLE_MEM_SIZE
BRAND
BUILD
CRASH_CONFIGURATION
CUSTOM_DATA ??
DEVICE_FEATURES
DEVICE_ID
DISPLAY
DROPBOX
DUMPSYS_MEMINFO
ENVIRONMENT
EVENTSLOG
FILE_PATH
INITIAL_CONFIGURATION
INSTALLATION_ID
IS_SILENT
LOGCAT
MEDIA_CODEC_LIST
PACKAGE_NAME
PHONE_MODEL
PRODUCT
RADIOLOG
REPORT_ID
SETTINGS_GLOBAL
SETTINGS_SECURE
SETTINGS_SYSTEM
SHARED_PREFERENCES
STACK_TRACE
THREAD_DETAILS
TOTAL_MEM_SIZE
USER_APP_START_DATE
USER_COMMENT
USER_CRASH_DATE
USER_EMAIL

    1. 분류기준

: 크래쉬 분석시 분류기준으로 잡아야할 사항에 대한 정의 필요
- AppVersion
- Crash Type
- Crash Address  : STACK_TRACE 로 잡으면 되나 내용이 방대함
- Device Type
- Android Version
- Catched Exception / uncatched Exception
-- End of Document--