빠른 수정 방법 (5분 내 완료)

1. 2024 프로젝트 전체 백업 복사본 생성
2. 프로젝트 루트 디렉터리의 project.json 파일을 텍스트 에디터로 열어 3가지 수정:
   • "studioVersion":"24.x.x" → "studioVersion":"22.10.xxx" (2022 최신 안정화 버전)
   • 모든 종속 패키지 버전을 2022 호환 버전으로 변경:
     • System: 22.10.x
     • UIAutomation: 22.10.x
     • Excel: 22.10.x
   • 2024 전용 필드 삭제: "schemaVersion":3.2, "crossPlatform":true
3. 저장 후 UiPath 2022에서 프로젝트 열기
4. 패키지 관리자에서 오류 발생 패키지 강제 다운그레이드 및 2024 전용 패키지 제거

안정적인 마이그레이션 방법 (권장)

1단계: 2024 버전 사전 처리

1. 2024 전용 기능 비활성화:
   • 신규 AI 활동, 브라우저 자동화, 변수 타입, 트리거 제거
   • 모든 활동을 2022 호환 기본 활동으로 교체
2. 종속 패키지를 22.10.x 시리즈로 수동 다운그레이드
3. 프로젝트 저장 후 Studio 종료

2단계: 2022 버전에서 신규 프로젝트 생성 및 마이그레이션

1. UiPath 2022에서 Windows 프로젝트 새로 생성(Windows-Legacy 제외)
2. 2024 프로젝트 폴더 내 모든 콘텐츠(.xaml, Data, Framework, Excel 템플릿 등)를 새 프로젝트로 복사
3. 종속성 일괄 수정:
   • 패키지 관리자에서 "시험판 포함" 옵션 해제
   • 22.10.x 안정화 패키지 설치
   • 누락된 활동 또는 네임스페이스 오류 발생 시 레거시 활동으로 교체

일괄 다운그레이드 (다중 프로젝트 처리)

1. UiPath 2024 Studio 홈 → 도구 → 프로젝트 종속성 일괄 업데이트 도구 실행
2. 2024 프로젝트 선택 후 모든 활동 패키지를 22.10.x 버전으로 일괄 변경
3. project.json 파일을 상기 "빠른 수정 방법"대로 수정

주요 문제 해결 방안

• 2024 전용 활동 오류: 신규 AI, Chrome 자동화, 루프 활동을 레거시 버전으로 교체
• 프레임워크 호환성: project.json에서 "targetFramework":"net48"로 명시적 설정
• 프로젝트 열기 실패 시: project.json 버전 수정 → 종속성 다운그레이드 순서 준수
• 다단계 다운그레이드: 2024→2023→2022 단계적 진행 권장

2022.10 호환 종속성 설정

"dependencies": {
  "UiPath.Credentials.Activities": "[22.10.2]",
  "UiPath.UIAutomation.Activities": "[22.10.10]",
  "UiPath.Excel.Activities": "[22.10.7]",
  "UiPath.System.Activities": "[22.10.8]",
  "UiPath.PDF.Activities": "[22.10.6]",
  "UiPath.Mail.Activities": "[22.10.5]",
  "UiPath.DataTable.Activities": "[22.10.3]",
  "UiPath.Java.Activities": "[22.10.3]",
  "UiPath.OCR.Activities": "[22.10.4]",
  "UiPath.Cryptography.Activities": "[22.10.2]",
  "UiPath.SAP.Activities": "[22.10.4]",
  "UiPath.FTP.Activities": "[22.10.2]",
  "UiPath.WebAPI.Activities": "[22.10.5]",
  "UiPath.Word.Activities": "[22.10.4]"
}

project.json 전체 구성 예시

{
  "name": "프로젝트명",
  "description": "",
  "main": "Main.xaml",
  "schemaVersion": "1.0",
  "studioVersion": "22.10.8",
  "projectVersion": "1.0.0",
  "targetFramework": "net48",
  "runtimeOptions": {
    "requiresUninstall": [],
    "allowPrerelease": false
  },
  "dependencies": {
    "UiPath.Credentials.Activities": "[22.10.2]",
    "UiPath.UIAutomation.Activities": "[22.10.10]",
    "UiPath.Excel.Activities": "[22.10.7]",
    "UiPath.System.Activities": "[22.10.8]",
    "UiPath.PDF.Activities": "[22.10.6]",
    "UiPath.Mail.Activities": "[22.10.5]",
    "UiPath.DataTable.Activities": "[22.10.3]",
    "UiPath.Java.Activities": "[22.10.3]",
    "UiPath.OCR.Activities": "[22.10.4]",
    "UiPath.Cryptography.Activities": "[22.10.2]",
    "UiPath.SAP.Activities": "[22.10.4]",
    "UiPath.FTP.Activities": "[22.10.2]",
    "UiPath.WebAPI.Activities": "[22.10.5]",
    "UiPath.Word.Activities": "[22.10.4]"
  }
}

필수 수정 사항

• 2024 전용 필드 삭제:
  • "crossPlatform": true
  • "schemaVersion": "3.x"
  • 모든 .NET6 관련 설정
• targetFramework 반드시 net48로 설정
• 버전 지정 시 [x.x.x] 고정 표기법 사용
• 2024 신규 활동은 수동 제거 필요