You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/en/manuals/version-control.md
-54Lines changed: 0 additions & 54 deletions
Original file line number
Diff line number
Diff line change
@@ -15,60 +15,6 @@ When you save changes in your local working copy, Defold tracks all changes in t
15
15
16
16
Select a file in the list and click <kbd>Diff</kbd> to view the changes that you have done to the file or <kbd>Revert</kbd> to undo all changes and restore the file to the state it had after the last synchronization.
17
17
18
-
## Synchronizing
19
-
20
-
::: important
21
-
Project synchronization can also be performed using one of the many excellent external tools for working with Git repositories. [GitHub Desktop](https://desktop.github.com/), [GitTower](https://www.git-tower.com), [Git Kraken](https://www.gitkraken.com/git-client) and [SourceTree](https://www.sourcetreeapp.com/) are some of the more popular ones.
22
-
:::
23
-
24
-
To synchronize your project means that the project files are brought into sync with the project as it looks on the remote server. You should synchronize if:
25
-
26
-
1. You want to bring your project up to speed with what is stored on the server.
27
-
2. You want to share your local project changes with other team members by committing and pushing your changes to the server.
28
-
29
-
To start synchronizing, select <kbd>File ▸ Synchronize</kbd> in the menu. A series of dialogs guide you through the synchronization process.
30
-
31
-
32
-
33
-
Press <kbd>Pull</kbd> to pull changes from the server and merge them with your local changes. If there are conflicts, you are asked to resolve them:
34
-
35
-
36
-
37
-
Mark each conflicting file, right-click and select the action to take:
38
-
39
-
View Diff
40
-
: Bring up a textual diff view of your and the server version of the file.
41
-
42
-
43
-
44
-
On the left hand side is the file pulled from the server. The right hand side shows your local version. Any differences are clearly highlighted so you can quickly review them.
45
-
46
-
The built-in file comparison tool works on text files only. However, since Defold stores all working files (game objects, collections, atlases, etc etc) in easily understandable JSON files, you can often figure out the meaning of the changes that have been made to such files:
47
-
48
-
Use Ours
49
-
: Discard the changes from the server and instead use your version.
50
-
51
-
Use Theirs
52
-
: Discard your version and instead use the server version.
53
-
54
-
::: sidenote
55
-
The editor does not allow you to pick changes from the two conflicting files. If you need to do this you can perform the Git operations from the command line and use a separate merge tool.
56
-
:::
57
-
58
-
When the editor is done pulling changes and any conflicts are resolved, a dialog asks you how to proceed.
59
-
60
-
61
-
62
-
* Press <kbd>Cancel</kbd> to abort and return the project to the state it was in prior to synchronization.
63
-
* Press <kbd>Push</kbd> to continue committing and pushing your changes to the server.
64
-
* Press <kbd>Done</kbd> to accept the server changes and conflict resolutions, but do not continue pushing. You can always push at a later stage.
65
-
66
-
If you continue pushing and have local changes, you are asked to commit them before pushing. A dialog allows you to select (stage) the files that should be included in the commit framed orange in the image below).
67
-
68
-
69
-
70
-
Press <kbd>Push</kbd> to commit and push your changes to the server.
71
-
72
18
## Git
73
19
74
20
Git is built primarily to handle source code and text files and stores those types of files with a very low footprint. Only the changes between each version are stored, which means that you can keep an extensive history of changes to all your project files to a relatively small cost. Binary files such as image or sound files, however, does not benefit from Git's storage scheme. Each new version you check in and synchronize takes about the same space. That is usually not a major issue with final project assets (JPEG or PNG images, OGG sound files etc) but it can quickly become an issue with working project files (PSD files, Protools projects etc). These types of files often grow very large since you usually work in much higher resolution than the target assets. It is generally considered best to avoid putting large working files under the control of Git and instead use a separate storage and backup solution for those.
Copy file name to clipboardExpand all lines: docs/ru/manuals/version-control.md
-54Lines changed: 0 additions & 54 deletions
Original file line number
Diff line number
Diff line change
@@ -15,60 +15,6 @@ Defold создан для небольших команд, которые в т
15
15
16
16
Выберите файл в списке и нажмите <kbd>Diff</kbd>, чтобы просмотреть изменения, которые вы внесли в файл, или <kbd>Revert</kbd>, чтобы откатить все изменения и восстановить файл до состояния, которое он имел после последней синхронизации.
17
17
18
-
## Синхронизация
19
-
20
-
::: important
21
-
Синхронизацию проекта также можно выполнить с помощью одного из множества отличных внешних инструментов для работы с Git репозиториями. [GitHub Desktop](https://desktop.github.com/), [GitTower](https://www.git-tower.com), [Git Kraken](https://www.gitkraken.com/git-client) и [SourceTree](https://www.sourcetreeapp.com/) - одни из наиболее популярных.
22
-
:::
23
-
24
-
Синхронизация проекта означает, что файлы проекта синхронизируются с состоянием проекта на удаленном сервере. Вам следует выполнять синхронизацию, если:
25
-
26
-
1. Вы хотите привести свой проект в соответствие с тем, что хранится на сервере.
27
-
2. Вы хотите поделиться своими локальными изменениями проекта с другими членами команды, зафиксировав и отправив свои изменения на сервер.
28
-
29
-
Чтобы начать синхронизацию, выберите в меню пункт <kbd>File ▸ Synchronize</kbd>. Последовательность диалогов проведет вас через процесс синхронизации.
30
-
31
-
32
-
33
-
Нажмите <kbd>Pull</kbd>, чтобы получить изменения с сервера и слить их с вашими локальными изменениями. Если есть конфликты, система попросит вас разрешить их:
34
-
35
-
36
-
37
-
Отметьте каждый конфликтующий файл, щелкните правой кнопкой мыши и выберите действие, которое нужно предпринять:
38
-
39
-
View Diff
40
-
: Вывести текстовое представление различий вашей и серверной версии файла.
41
-
42
-
43
-
44
-
Слева находится файл, полученный с сервера. Справа показана ваша локальная версия. Любые различия четко выделены, так что вы можете быстро их просмотреть.
45
-
46
-
Встроенный инструмент сравнения файлов работает только с текстовыми файлами. Однако, поскольку Defold хранит все рабочие файлы (игровые объекты, коллекции, атласы и т. д.) в легко читаемых файлах JSON, вы зачастую сможете понять смысл изменений, которые были внесены в такие файлы:
47
-
48
-
Use Ours
49
-
: Отменить изменения с сервера и вместо этого использовать вашу версию.
50
-
51
-
Use Theirs
52
-
: Выкинуть свою версию и использовать вместо нее версию сервера.
53
-
54
-
::: sidenote
55
-
Редактор не позволяет точечно отбирать изменения из обоих конфликтующих файлов. Если вам нужно это сделать, вы можете выполнять Git операции из командной строки и использовать отдельный инструмент слияния.
56
-
:::
57
-
58
-
Когда редактор закончит с подтягиванием изменений и все конфликты будут разрешены, появится диалоговое окно с вопросом, как действовать дальше.
59
-
60
-
61
-
62
-
* Нажмите <kbd>Cancel</kbd>, чтобы прервать операцию и вернуть проект в состояние, в котором он находился до синхронизации.
63
-
* Нажмите <kbd>Push</kbd>, чтобы продолжить с фиксацией и публикацией ваших изменений на сервер.
64
-
* Нажмите <kbd>Done</kbd>, чтобы принять изменения с сервера и разрешения конфликтов, но без последующей публикации. Вы всегда можете опубликоваться на сервер на более позднем этапе.
65
-
66
-
Если вы продолжаете публикацию и имеете локальные изменения, вас попросят зафиксировать (commit) их перед публикацией (push-ем). Диалоговое окно позволяет вам выбрать (подготовить) файлы, которые должны быть включены в коммит (обведено оранжевой рамкой на изображении ниже).
67
-
68
-
69
-
70
-
Нажмите <kbd>Push</kbd>, чтобы зафиксировать и отправить изменения на сервер.
71
-
72
18
## Git
73
19
74
20
Инструмент Git создан в первую очередь для обработки исходного кода и текстовых файлов и хранит эти типы файлов с минимальными издержками. Сохраняются только изменения (дельты) между каждой версией, что означает, что вы можете вести обширную историю изменений всех файлов вашего проекта с относительно небольшими затратами. Однако двоичные файлы, такие как изображения или звуковые файлы, не получают преимуществ от схемы хранения Git. Каждая новая версия, которую вы регистрируете и синхронизируете, занимает примерно одно и то же место. Обычно это не является серьезной проблемой с конечными ассетами проекта (изображения JPEG или PNG, звуковые файлы OGG и т. д.), н может быстро стать проблемой с рабочими файлами проекта (файлы PSD, проекты Protools и т. д.). Эти типы файлов часто сильно разрастаются в объеме, поскольку вы обычно работаете с гораздо более высоким разрешением, чем целевые ресурсы. Обычно считается, что лучше избегать передачи больших рабочих файлов для Git версионирования и вместо этого использовать для них отдельное хранилище и решение для резервного копирования.
0 commit comments