개발환경을 아래와 순서로 진행 됩니다.
설치 순서는 다음과 같습니다.
1. SVN 설치
윈도우용 클라이언트를 다운로드 받는다.
설치를마친 후 탐색기를 열고 솔루션 루트가 될 폴더에서 마우스 우클릭으로 Check-out을 한다.
- Check-out을 선택한다.
- SVN 주소(EndPoint)와 사용자ID / Password 를 관리자로부터 제공 받는다.
- ex) svn://svc1.trustsys.net/UBi3Project
UBi3의 Root가 될 폴더를정한다.
이후 전부 그 하위에 위치하게 된다.
일부 디렉토리는 꼭 지정된 이름을 사용해야 한다.
root(UBi3)\
+ UBi3FrameWork
+ FrameWorkReference {프레임워크 UX 개발에 사용되는 Control과 컴포넌트 dll}
+ Server ------------{개발 디버그용 local server}
+ sw ----------------{프로젝트에 사용되는 설치프로그램들... : VisualStudio 2019, DevExpress 20.1.x 등}
+ UBI3Projects---------{프로젝트가 위치할 최상위 폴더}
+ MyProject1---------{프로젝트폴더}
+ TestProject--------{프로젝트 2}
+ ..
1. SVN Check-out
https://110.45.156.44/svn/UBi3FrameWork
svnuser=guest, password=1
FrameWork를 처음 Check-out 했을때 폴더내에 생기는 하위구조
UBi3 --------------------[프레임워크의 최상위 Folder]
+ UBi3Framework
+ FrameWorkReference {프레임워크 UX 개발에 사용되는 Control과 컴포넌트 dll}
+ Server ------------{개발 디버그용 local server}
+ sw ----------------{프로젝트에 사용되는 설치프로그램들... : VisualStudio 2019, DevExpress 20.1.x 등}
2. VisualStudio 2019 설치 * svn 체크아웃 후에 생성된 sw폴더에서 찾을수 있음 * 설치시에 워크로드 탭의 구성은 **ASP.NET 및 웹개발, .NET 테스크톱 개발, Office/SharePoint 개발** 등 을 선택하고 설치한다. * 개별구성요소는 **.NET Framework 4.7.2** 와 **ClickOnce 게시** 을 선택하여 설치한다.
3. DevExpress 20.1.7 설치 * svn 체크아웃 후에 생성된 sw폴더에서 찾을수 있음
4. SVN 설치 for Visual Studio * VisualStudio SVN 플러그인 설치 * VisualStudio 메뉴>확장(X)>확장관리(M)> 에서 "visualSVN"을 검색하여 설치한다. * 설치가 끝난 후 메뉴에서 /도구/옵션/소스제어 항목에 VisualSVN을 선택한다.
5. Project Check-out
Projects 하위에 체크아웃 한다.
Projects 하위 폴더는 실제 사이트의 개발Project가 되며 프로젝트 ID를 폴더이름으로 사용하도록 한다.
예) 서울전선 ⇒ SEC, 등…
UBi3
+ Projects
+ SEC-------> 서울전선 프로젝트
+ Comm ---> 공통화면
+ Main ---> 진입점{Program.cs}
+ Menual--> 각 화면에서 호출될 설명서.pdf
+ Screens-> Release로 컴파일된 개별화면.dll
+ SYS-----> 시스템 기본기능 화면
+ UX------> 각 업무용 화면(내주 하위 업무구조 구성)
+ BComp-----> B사 프로젝트
+ Comm ---> 공통화면
+ Main ---> 진입점{Program.cs}
+ Menual--> 각 화면에서 호출될 설명서.pdf
+ Screens-> Release로 컴파일된 개별화면.dll
+ SYS-----> 시스템 기본기능 화면
+ UX------> 각 업무용 화면(내주 하위 업무구조 구성)
+ CComp-----> C사 프로젝트
+ Comm ---> 공통화면
+ Main ---> 진입점{Program.cs}
+ Menual--> 각 화면에서 호출될 설명서.pdf
+ Screens-> Release로 컴파일된 개별화면.dll
+ SYS-----> 시스템 기본기능 화면
+ UX------> 각 업무용 화면(내주 하위 업무구조 구성)
6. 로컬서버 환경변수 등록 - 변수이름 : UBI3_SERVER - 변수값 : svn-Checkout한 디렉토리의 Server폴더를 지정
7. Visual Studio 툴박스 설정
1) 새 도구상자 탭을 만든다. 이름은 'UBi3'로 한다.
2) 도구상자에 Framework 컨드롤을 등록한다.
- UBi3 탭을 마우스 오른족으로 선택하여 '항목선택'을 누르고
'찾아보기(R)'을 눌러 checkout했던 svn 솔루션 포더에서 'FrameWorkReference' 폴더안에
'UBi.Winform.Controls.dll' 파일을 찾아 선택하고 등록하면 된다
* 도구상자 등록은 Winform 디자인이 열린상태에서만 가능
→ 
7. 개발 디버그환경 구축하기
1) svn 루트 및에 Server폴더가 있는지 확인한다. 이 폴더는 Checkout시에 자동으로 생성된다.
2) 서버 기본정보 파일확인
UBI3/UBi3FrwmeWork/Server/
../Data ------------------------------- 서버환경 기본디텍토리
+file ---------------------------- 클라이언트에서 어플케이션에서 파일 저장용도로 사용하는 폴더
+logs ---------------------------- 시스템로그
+menual -------------------------- UX 메뉴얼
+settings ------------------------ 서버가동 환경지정
f: ServiceSettings.json
=> {"LoginID":"a","Password":"a","EncryptKey":"salte69","Certificate":""}
=> {"접속ID":"a","접속패스워드":"a","구간암호화 키":"salte69","인증서":""} : 인증서 없이는 Localhost만 운용가능
+service ----------------------- 개발중인 데이터베이스의 환경이 구성되는 폴더
f: 서비스명.json -------------- 개발중인 사이트 갯수만큼 등록됨
=> **아래 내용중 주어진 정보에 따라 #으로 코멘트한 내용을 적절하게 수정해야 한다.**
{
"ServiceInfo": {
"Name": "서비스ID",
"Url": "http://localhost:5000/api",
"Port": 5000,
"UserID": "a",
"Password": "a"
},
"DBInfo": {
"DBServerAddress": "localhost", # DB IP
"DBPort": 3306, # DB Port
"DBSID": "test1", # db명
"DBUserID": "user1", # DB login id
"DBPassword": "password", # DB password
"CommandTimeout": 30000, # time-out
"DBType": 3 # 데이터베이스 타입 {1: Oracle, 2 SQLServer, 3:Maria, 4:PostgreSQL}
},
"DataPath": "",
"ServiceStatus": 1,
"UseDBLog": true,
"DBLogTableName": "SYS_ERRLOG",
"SaveDatabaseContent": true,
"GoogleApiKey":"..."
}
+setup --------------------------- 솔루션 배포파일
+update -------------------------- 화면 배포파일
3) local환경에서 서비스는 무제한으로 등록할수 있습니다.
참고로 local서버는 local에서만 접속가능 합니다.
4) RESTful Service는 .net 3.1 기반의 서비스 이므로 /UBi3FrameWork/sw 폴더내에 있는
dotnet-sdk-3.1.425-win-x64를 설치해야 한다.
8. 개발 디버그 모드 UBI3_SERVER 환경변수에 등록된 path에 'UBi.Net.RestfulServer.exe' 실행 파일을 실행하면 ../UBi3/UBi3FrameWork/Server/Data/settings/service 폴더에 있는 서비스 파일들이 로딩된다. 서비스 파일들은 실행중에도 편집과 추가 삭제가 가능하다. 서비스 파일내용에 DataBase 주소, user, password 등을 수시로 수정할 수 있으며 바뀐 내용은 즉시 적용된다.
UX화면을 개발환경에서 열게되면 자동으로 아래창이 활성화 된다. 만일 그렇지 않다면 UBI_SERVER 환경변수에 서비스가 있는 폴더를 지정해야 한다. 또한 dotnet-sdk-3.1.425-win-x64가 설치됬는지 확인해야 한다. 실행하게 되면 우선 폴더안에 있는 모든 서비스를 바인딩한다. 이 프로그램은 단축 아이콘으로 작업표시줄에 넣고 실행하는 것을 추천한다.
테스트 진행중 서비스창에서 호출되는 Procedure내용을 볼수 있으며 넘어가는 파라메터 값과 실행중 발생하는 오류등이 표시된다. DB서버의 Procedure를 디버그 하기에 유용하다.
- * 서버에 배치될 Release서비스는 디버그 메세지를 만들지 않는다.
예외로 Exception 발생은 log파일에 기록 된다.