Ruby Mine에서 2인치 속도로 Ruby 어플리케이션의 아키텍처/₂ 분 단위

AppMap는 코드가 작동할 때 어떻게 작동하는지 보여주면서 코드를 개선하는 데 도움을 주는 오픈 소스 Ruby Mine 플러그인입니다.이것은 편집기에서 구조와 코드 행위를 자동으로 생성하는 상호작용 지도를 통해 이를 실현한다.
이것은 2ñ/₂ 분 비디오는 AppMap 플러그인을 설치하는 방법, Ruby 애플리케이션을 매핑하도록 구성하는 방법, 대화형 차트 탐색 코드를 사용하는 방법을 보여줍니다.
Rails 샘플 응용 프로그램을 샘플 프로그램으로 사용합니다.
다음은 비디오에서 설명하는 단계별 지침입니다. 또는 Ruby Mine IDE에서 직접 Quickstart AppMap instructions에 따라 조작할 수 있습니다.

작업 원리

앱맵은 응용 프로그램의 코드 실행 경로를 기록하고 코드 편집기의 대화형 다이어그램에서 직접 시각화하는 방식으로 작동합니다.AppMaps를 만드는 가장 좋은 방법은 단원, 기능 또는 테스트 용례를 기록하는 것이다.Rail 예제 응용 프로그램 항목은 이 프레젠테이션에서 AppMaps의 소스가 될 minitest 테스트를 사용합니다.

AppMap 플러그인 설치

00:03 JetBrains Marketplace에서 AppMap을 설치하는 데 소요되는 시간은 다음과 같습니다.

RubyMine 기본 설정 열기

플러그인을 선택하고 Marketplace 탭을 클릭하여 검색AppMap

Install버튼을 클릭하고Restart IDE버튼을 눌러라.

IDE가 재부팅되면 AppMap 플러그인이 설치되어 AppMaps를 볼 준비가 됩니다.

Rails 샘플 응용 프로그램 녹화를 위한 AppMap 구성

1. 미니테스트에 appmap gem, appmap railtie, appmap 추가

00:10 첫 번째 단계에서 AppMap 기록 프로그램에 기기를 삽입합니다.appmap gem를gem 파일에 추가한 다음 bundle를 실행하여 설치합니다.

group :development, :test do
  gem 'appmap'

00:18 다음에 appmap railtie를 추가합니다.appmap gem가 패키지에 있을 때만 railtie가 활성화됩니다.

require 'appmap/railtie' if %w[test development].member?(Rails.env)

00:27 Rails 예제 응용 프로그램에서 minitest를 사용합니다.에 test_helper.rb, 추가

require 'appmap/minitest'

이것은 모든 응용 프로그램 코드가 불러오기 전에 두어야 한다.

2. 앱맵을 구성합니다.yml

AppMap 프레임워크는 이름appmap.yml이라는 파일을 사용하여 매핑할 코드를 결정합니다.00:42 프로젝트의 루트 폴더에 새 파일을 만듭니다appmap.yml.포획하고 싶은 프로젝트의 모든 원본 폴더와 보석을 추가해야 합니다.다음은 이 프레젠테이션에 사용된 Rails 예제 애플리케이션의 예입니다.

name: sample_app_6th_ed
packages:
- path: app/controllers
- path: app/helpers
- path: app/jobs
- path: app/mailers
- path: app/models
- gem: image_processing
- gem: mini_magick
- gem: active_storage_validations
- gem: bcrypt
- gem: will_paginate

테스트에서 AppMaps 기록

00:58 이제 앱맵을 녹화할 수 있습니다.기록을 얻으려면 환경 변수APPMAP=true를 사용하여 테스트를 실행하십시오.
테스트 실행 구성을 수정하여 RubyMine에 APPMAP 변수를 쉽게 포함할 수 있습니다.

테스트가 실행될 때 AppMap은 tmp/appmap/minitest 폴더에 기록됩니다.

참고: 명령줄에서 직접 테스트를 실행하고 AppMaps를 기록할 수 있습니다.

$ APPMAP=true bundle exec rake test

RubyMine에서 생성된 AppMap 열기

01:17 AppMaps 보기 열기 - UI에서 AppMaps 탭을 클릭합니다.또는 CTRL or COMMAND + SHIFT + A를 누르고 검색 상자에 "AppMaps"를 입력한 다음 목록에서 "AppMaps 보기"를 선택합니다.
프로젝트 폴더에서 찾은 모든 AppMap 목록에서 AppMap을 선택하거나 특정 구문을 포함하는 AppMap을 검색합니다.
목록에서 AppMap을 두 번 클릭하면 대화식 차트 뷰어가 열립니다.

AppMap 그림과 상호 작용

01:20 AppMap 차트에서 Rails 예제 애플리케이션의 작동 방식을 알아봅니다.

소프트웨어 디자인의 전반적인 국면에서 출발하여 의존 관계도에 있는 모든 코드 구성 요소인 웹 서비스 노드, 자바 패키지/클래스/함수와 SQL 명령 및 상호 의존 관계를 살펴본다

도표에서 클래스와 함수의 원본을 직접 탐색하면 수동으로 찾을 필요가 없다

실행 추적 중의 코드와 SQL의 실행 세부 사항을 깊이 있게 살펴본다.

아니면, 아래에서 위로 올라가는 방법을 사용할 수 있다.어떤 코드가 데이터베이스에 있는 데이터를 수정하는지 알고 싶다고 가정하십시오.

관심 있는 SQL 명령부터 시작합니다. 예를 들어 업데이트

추적 중인 다른 호출에 어떻게 연결되는지 보고 호출된 구성 요소로 거슬러 올라가 원본 파일을 엽니다

다른 코드와 웹 서비스 포트에 어떻게 연결되는지 확인합니다.

AppMap에 대한 자세한 내용

이것은 단지 AppMap 기능의 작은 시범일 뿐이다.자세한 내용, 단계별 지침 및 실제 작동 방법은 AppMap documentation를 참조하십시오.
감사를 드리다
화단 씨가 이 영상에서 부지런히 일해 주셔서 감사합니다!