You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

ios-tutorial.html 9.9KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152
  1. <!DOCTYPE html>
  2. <html>
  3. <meta charset="utf-8">
  4. <head>
  5. <style>
  6. #header
  7. {
  8. background: #2BA6E3;
  9. padding: 0.7em;
  10. text-align: left;
  11. }
  12. #header a
  13. {
  14. color: white;
  15. text-decoration: none;
  16. padding: 0.5em 1em 0.5em 1em;
  17. }
  18. #lang
  19. {
  20. float: right;
  21. }
  22. .news_item
  23. {
  24. background: #FFFFFF;
  25. width: 720px;
  26. padding: 1em;
  27. margin-top: 2em;
  28. margin-bottom: 2em;
  29. border: 1px solid #E0E0E0;
  30. text-align: left;
  31. }
  32. .news_item_contents
  33. {
  34. color: #444;
  35. line-height: 1.5em;
  36. }
  37. .news_item_date
  38. {
  39. margin-bottom: 2em;
  40. color: #aaa;
  41. }
  42. html
  43. {
  44. font-family: sans-serif;
  45. }
  46. body
  47. {
  48. background: #FAFAFA;
  49. }
  50. code, pre
  51. {
  52. font-family: monospace, serif;
  53. font-size: 1em;
  54. color: #7f0a0c;
  55. }
  56. /*
  57. figure
  58. {
  59. margin: 0px;
  60. padding: 0px;
  61. }
  62. */
  63. img
  64. {
  65. width: 720px;
  66. }
  67. a
  68. {
  69. color: #3A91CB;
  70. text-decoration: none;
  71. }
  72. table
  73. {
  74. border-collapse: collapse;
  75. }
  76. table, th, td
  77. {
  78. border: 1px solid #aaa;
  79. padding: 0.5em;
  80. margin-top: 0.5em;
  81. margin-bottom: 0.5em;
  82. }
  83. </style>
  84. </head>
  85. <body>
  86. <div id="header">
  87. <strong id="title">Open Game Studio</strong>
  88. <a href="../../ru/news/index.html">Новости</a>
  89. <a href="../../ru/game/index.html">Игры</a>
  90. <a href="../../ru/tool/index.html">Инструменты</a>
  91. <a href="../../ru/page/about.html">О нас</a>
  92. <div id="lang">
  93. <a href="../../en/news/ios-tutorial.html">EN</a>
  94. <a href="../../ru/news/ios-tutorial.html">RU</a>
  95. </div>
  96. </div>
  97. <center>
  98. <h1>В новостях...</h1>
  99. <div class="news_item">
  100. <h2 class="news_item_title">
  101. <a href="ios-tutorial.html">Самоучитель iOS</a>
  102. </h2>
  103. <p class="news_item_date">
  104. 2017-06-08 10:00
  105. </p>
  106. <div class="news_item_contents">
  107. <p><img src="../../images/2017-06-08-ios-refactoring.png" alt="Земля и ракета" /></p>
  108. <p>Эта статья описывает проблемы, с которыми мы столкнулись во время создания самоучителя для iOS в мае 2017.</p>
  109. <p><a href="https://twitter.com/OpenGameStudio/status/826816343433498627">В феврале</a> мы сумели отобразить простую модель под iOS за считанные дни. Это дало нам уверенность, что самоучитель для iOS мы сделаем столь же быстро. Тем не менее, реальность напомнила нам о простой вещи: быстро сделать можно лишь поделку на коленке, работающую только у самого разработчика; над логически связанным примером, работающим у всех, придётся попотеть.</p>
  110. <p><strong>Нативная библиотека</strong></p>
  111. <p>Прежде всего нам необходимо было ответить на следующий вопрос: "должен ли пример приложения быть частью проекта Xcode или отдельной библиотекой?"</p>
  112. <p>Для принятия решения мы использовали следующие факты:</p>
  113. <ol>
  114. <li>Проект Xcode может напрямую использовать C++ (благодаря Objective-C++) без прослоек вроде JNI<ul>
  115. <li>Отдельная библиотека не нужна (+ приложение)</li>
  116. <li>Создание отдельной библиотеки - это дополнительная работа (- библиотека)</li></ul></li>
  117. <li>OpenSceneGraph собирается в библиотеки<ul>
  118. <li>Легче использовать стандартный процесс сборки (+ библиотека)</li>
  119. <li>Создавать свой процесс сборки лишь для одной платформы сложно (- приложение)</li></ul></li>
  120. <li>OpenSceneGraph использует систему сборки CMake, которая не поддерживается Xcode<ul>
  121. <li>Проект Xcode не может включать файлы CMake (- приложение)</li>
  122. <li>Свой файл CMake может с лёгкостью включить файл OpenSceneGraph CMake для сборки единой библиотеки (+ библиотека)</li></ul></li>
  123. <li>CMake может генерировать проект Xcode<ul>
  124. <li>Можно создать файл CMake, который будет собирать как OpenSceneGraph, так и пример приложения (+ приложение)</li>
  125. <li>Xcode - это де-факто инструмент для создания проектов Xcode; легче использовать стандартный процесс сборки (+ библиотека)</li></ul></li>
  126. </ol>
  127. <p>Оценив плюсы и минусы обоих подходов, мы решили сделать библиотеку, которую можно включать в проект Xcode. Минусом данного подхода является то, что сборки приложения для симулятора и реального устройства используют разные сборки библиотеки.</p>
  128. <p><strong>Рефакторинг</strong></p>
  129. <p>Также нам пришлось ответить на ещё один вопрос: "использовать ли единую кодовую базу для всех платформ или несколько под каждую платформу?"</p>
  130. <p>При создании самоучителя для Android мы использовали единую кодовую базу, т.к. она отлично работала для десктопа и Android. Когда мы начали работу над самоучителем iOS, стало ясно, что часть функционала либо работает, либо не работает на некоторых платформах. Например, один функционал может работать на десктопе и iOS, но не работать на Android. Другой функционал может работать на iOS и Android, но не работать на десктопе. Т.к. мы не хотели загрязнять код кучей #ifdef, мы решили помещать функционал, специфичный для конкретной платформы или нескольких платформ, в разные файлы. Это привело к резкому увеличению количества файлов. Такой подход хорошо подходил для повторного использования, но совершенно не годился для понимания общей картины.</p>
  131. <p>В этот момент мы осознали необходимость ответа на второй вопрос. Мы напомнили себе, что главная цель примера приложения состоит в том, чтобы обучить базовым вещам OpenSceneGraph, а не создать повторно используемую библиотеку с API, который будет жить без изменений десятилетиями.</p>
  132. <p>Для ответа на этот вопрос нам помог наш внутренний инструмент feature tool. С его помощью мы разделили код на несколько частей, который в итоге собирается ровно в два файла для каждой платформы:</p>
  133. <ol>
  134. <li>functions.h - содержит повторно используемые бесклассовые функции</li>
  135. <li>main.h - содержит остальной код приложения</li>
  136. </ol>
  137. <p>Их содержимое несколько отличается для каждой из платформ, но наличие всего двух файлов позволяет увидеть общую картину.</p>
  138. <p>На этом мы заканчиваем описание проблем, с которыми мы столкнулись во время создания самоучителя для iOS в мае 2017.</p>
  139. </div>
  140. </div>
  141. <div id="footer">
  142. Сайт сгенерирован <a href="http://opengamestudio.org/pskov/ru">ПСКОВОМ</a>
  143. из <a href="http://github.com/ogstudio/site-opengamestudio">этого исходного кода</a>.
  144. Сайт размещён на <a href="https://pages.github.com">GitHub Pages</a>.
  145. </div>
  146. </center>
  147. </body>
  148. </html>