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.

151 line
10KB

  1. <!DOCTYPE html>
  2. <head>
  3. <meta charset="utf-8" />
  4. <!-- Set the viewport width to device width for mobile -->
  5. <meta name="viewport" content="width=device-width" />
  6. <title>Самоучитель iOS</title>
  7. <link rel="stylesheet" href="http://opengamestudio.org/theme/css/normalize.css" />
  8. <link rel="stylesheet" href="http://opengamestudio.org/theme/css/foundation.min.css" />
  9. <link rel="stylesheet" href="http://opengamestudio.org/theme/css/style.css" />
  10. <link rel="stylesheet" href="http://opengamestudio.org/theme/css/pygments.css" />
  11. <script src="http://opengamestudio.org/theme/js/custom.modernizr.js"></script>
  12. <!-- So Firefox can bookmark->"abo this site" -->
  13. <link href="feeds/all.atom.xml" rel="alternate" title="Opensource Game Studio" type="application/atom+xml">
  14. </head>
  15. <body>
  16. <!-- Nav Bar -->
  17. <nav>
  18. <!-- Show menu items and pages -->
  19. <div class="row">
  20. <div class="large-12 columns top-bar">
  21. <h1><a href="http://opengamestudio.org">Opensource Game Studio</a></h1>
  22. </div>
  23. </div>
  24. <div class="row top-menu">
  25. <div class="large-12 columns">
  26. <a href="/pages/projects.html" class="menu-button secondary">Projects</a>
  27. <a href="/pages/about.html" class="menu-button secondary">About</a>
  28. </div>
  29. </div>
  30. </nav>
  31. <!-- End Nav -->
  32. <!-- Main Page Content and Sidebar -->
  33. <div class="row">
  34. <!-- Main Blog Content -->
  35. <div class="large-9 columns">
  36. <article>
  37. <header>
  38. <h3 class="article-title"><a href="http://opengamestudio.org/ios-tutorial-ru.html" rel="bookmark"
  39. title="Permalink to Самоучитель iOS">Самоучитель iOS</a></h3>
  40. </header>
  41. <h6 class="subheader" title="2017-06-08T10:00:00+03:00">Thu 08 June 2017
  42. <a class="button secondary small translation-button" href="http://opengamestudio.org/ios-tutorial.html">en</a>
  43. </h6> <p><img alt="Самоучитель iOS" src="http://opengamestudio.org/2017-06-08-ios-refactoring.png"></p>
  44. <p>Эта статья описывает проблемы, с которыми мы столкнулись во время создания самоучителя для iOS в мае 2017.</p>
  45. <p><a href="https://twitter.com/OpenGameStudio/status/826816343433498627">В феврале</a> мы сумели отобразить простую модель под iOS за считанные дни. Это дало нам уверенность, что самоучитель для iOS мы сделаем столь же быстро. Тем не менее, реальность напомнила нам о простой вещи: быстро сделать можно лишь поделку на коленке, работающую только у самого разработчика; над логически связанным примером, работающим у всех, придётся попотеть.</p>
  46. <h3>Нативная библиотека</h3>
  47. <p>Прежде всего нам необходимо было ответить на следующий вопрос: "должен ли пример приложения быть частью проекта Xcode или отдельной библиотекой?"</p>
  48. <p>Для принятия решения мы использовали следующие факты:</p>
  49. <ol>
  50. <li>Проект Xcode может напрямую использовать C++ (благодаря Objective-C++) без прослоек вроде JNI<ul>
  51. <li>Отдельная библиотека не нужна (+ приложение)</li>
  52. <li>Создание отдельной библиотеки - это дополнительная работа (- библиотека)</li>
  53. </ul>
  54. </li>
  55. <li>OpenSceneGraph собирается в библиотеки<ul>
  56. <li>Легче использовать стандартный процесс сборки (+ библиотека)</li>
  57. <li>Создавать свой процесс сборки лишь для одной платформы сложно (- приложение)</li>
  58. </ul>
  59. </li>
  60. <li>OpenSceneGraph использует систему сборки CMake, которая не поддерживается Xcode<ul>
  61. <li>Проект Xcode не может включать файлы CMake (- приложение)</li>
  62. <li>Свой файл CMake может с лёгкостью включить файл OpenSceneGraph CMake для сборки единой библиотеки (+ библиотека)</li>
  63. </ul>
  64. </li>
  65. <li>CMake может генерировать проект Xcode<ul>
  66. <li>Можно создать файл CMake, который будет собирать как OpenSceneGraph, так и пример приложения (+ приложение)</li>
  67. <li>Xcode - это де-факто инструмент для создания проектов Xcode; легче использовать стандартный процесс сборки (+ библиотека)</li>
  68. </ul>
  69. </li>
  70. </ol>
  71. <p>Оценив плюсы и минусы обоих подходов, мы решили сделать библиотеку, которую можно включать в проект Xcode. Минусом данного подхода является то, что сборки приложения для симулятора и реального устройства используют разные сборки библиотеки.</p>
  72. <h3>Рефакторинг</h3>
  73. <p>Также нам пришлось ответить на ещё один вопрос: "использовать ли единую кодовую базу для всех платформ или несколько под каждую платформу?"</p>
  74. <p>При создании самоучителя для Android мы использовали единую кодовую базу, т.к. она отлично работала для десктопа и Android. Когда мы начали работу над самоучителем iOS, стало ясно, что часть функционала либо работает, либо не работает на некоторых платформах. Например, один функционал может работать на десктопе и iOS, но не работать на Android. Другой функционал может работать на iOS и Android, но не работать на десктопе. Т.к. мы не хотели загрязнять код кучей #ifdef, мы решили помещать функционал, специфичный для конкретной платформы или нескольких платформ, в разные файлы. Это привело к резкому увеличению количества файлов. Такой подход хорошо подходил для повторного использования, но совершенно не годился для понимания общей картины.</p>
  75. <p>В этот момент мы осознали необходимость ответа на второй вопрос. Мы напомнили себе, что главная цель примера приложения состоит в том, чтобы обучить базовым вещам OpenSceneGraph, а не создать повторно используемую библиотеку с API, который будет жить без изменений десятилетиями.</p>
  76. <p>Для ответа на этот вопрос нам помог наш внутренний инструмент feature tool. С его помощью мы разделили код на несколько частей, который в итоге собирается ровно в два файла для каждой платформы:</p>
  77. <ol>
  78. <li>functions.h - содержит повторно используемые бесклассовые функции</li>
  79. <li>main.h - содержит остальной код приложения</li>
  80. </ol>
  81. <p>Их содержимое несколько отличается для каждой из платформ, но наличие всего двух файлов позволяет увидеть общую картину.</p>
  82. <p>На этом мы заканчиваем описание проблем, с которыми мы столкнулись во время создания самоучителя для iOS в мае 2017.</p>
  83. <p class="subheader">Category: <a href="http://opengamestudio.org/category/news.html">News</a>
  84. </p>
  85. </article>
  86. </div>
  87. <!-- End Main Content -->
  88. <!-- Sidebar -->
  89. <aside class="large-3 columns">
  90. <!--k
  91. <h5 class="sidebar-title">Site</h5>
  92. <ul class="side-nav">
  93. <li><a href="http://opengamestudio.org/archives.html">Archives</a>
  94. <li><a href="http://opengamestudio.org/tags.html">Tags</a>
  95. <li><a href="http://opengamestudio.org/feeds/all.atom.xml" rel="alternate">Atom feed</a></li>
  96. </ul>
  97. <h5 class="sidebar-title">Categories</h5>
  98. <ul class="side-nav">
  99. <li><a href="http://opengamestudio.org/category/news.html">News</a></li>
  100. <li><a href="http://opengamestudio.org/category/stub.html">Stub</a></li>
  101. </ul>
  102. -->
  103. <h5 class="sidebar-title">Projects</h5>
  104. <ul class="side-nav">
  105. <li><a href="/pages/ogs-mahjong.html">OGS Mahjong</a></li>
  106. <li><a href="/pages/ogs-editor.html">OGS Editor</a></li>
  107. <li><a href="/pages/openscenegraph-guide.html">OpenSceneGraph guide</a></li>
  108. </ul>
  109. </aside> <!-- End Sidebar -->
  110. </div> <!-- End Main Content and Sidebar -->
  111. <!-- Footer -->
  112. <footer class="row">
  113. <div class="large-12 columns">
  114. <hr />
  115. <div class="row">
  116. <div class="large-7 columns">
  117. <p>Proudly powered by <a href="http://getpelican.com">Pelican</a>, which takes great advantage of <a href="http://python.org">Python</a>.</p>
  118. </div>
  119. </div>
  120. </div>
  121. </footer>