Merge branch 'develop'

README.md

@@ -26,7 +26,7 @@ Add the dependency in your build.gradle:
 ```groovy
 dependencies {
     //Cicerone
-    compile 'ru.terrakok.cicerone:cicerone:X.X'
+    compile 'ru.terrakok.cicerone:cicerone:X.X.X'
 }
 ```
 
@@ -100,6 +100,8 @@ protected void executeCommand(Command command) {
 Navigator processes the navigation commands. Usually it is an anonymous class inside the Activity.  
 Activity provides Navigator to the CommandBuffer in _onResume_ and removes it in _onPause_.  
 
+**Attention**: Use _onResumeFragments()_ with FragmentActivity ([more info](https://developer.android.com/reference/android/support/v4/app/FragmentActivity.html#onResume()))
+
 ```java
 @Override
 protected void onResume() {

README_RUS.md

@@ -16,7 +16,7 @@ Cicerone (_"чи-че-ро́-не"_ - устар. гид) - легкая биб
 ```groovy
 dependencies {
     //Cicerone
-    compile 'ru.terrakok.cicerone:cicerone:X.X'
+    compile 'ru.terrakok.cicerone:cicerone:X.X.X'
 }
 ```
 И инициализируйте библиотеку, например, так:
@@ -88,6 +88,8 @@ protected void executeCommand(Command command) {
 Navigator - (например) анонимный класс внутри Activity, который реализует команды навигации.
 Activity предоставляет свой Navigator для CommandBuffer в методе _onResume_ и очищает в _onPause_
 
+**Внимание**: В FragmentActivity следует использовать _onResumeFragments()_. ([подробнее](https://developer.android.com/reference/android/support/v4/app/FragmentActivity.html#onResume()))
+
 ```java
 @Override
 protected void onResume() {
@@ -109,7 +111,7 @@ private Navigator navigator = new Navigator() {
 };
 ```
 
-Навигатор не обязана быть в Activity. Он может быть и внутри Fragment'а, который переключает внутри себя View.
+Навигатор не обязан быть в Activity. Он может быть и внутри Fragment'а, который переключает внутри себя View.
 
 ## Команды навигатора
 Для большинства задач предоставленных в библиотеке команд должно хватить, но их всегда можно дополнить собственными!

library/build.gradle

@@ -15,7 +15,7 @@ ext {
     bintrayName = 'cicerone'
     publishedGroupId = 'ru.terrakok.cicerone'
     artifact = 'cicerone'
-    libraryVersion = '1.2'
+    libraryVersion = '1.2.1'
     gitUrl = 'https://github.com/terrakok/Cicerone'
     allLicenses = ['MIT']
 }

library/src/main/java/ru/terrakok/cicerone/android/FragmentNavigator.java

@@ -145,5 +145,6 @@ protected void backToUnexisting() {
      * Called if we can't create a screen.
      */
     protected void unknownScreen(Command command) {
+        throw new RuntimeException("Can't create a screen for passed screenKey.");
     }
 }

library/src/main/java/ru/terrakok/cicerone/android/SupportFragmentNavigator.java

@@ -144,5 +144,6 @@ protected void backToUnexisting() {
      * Called if we can't create a screen.
      */
     protected void unknownScreen(Command command) {
+        throw new RuntimeException("Can't create a screen for passed screenKey.");
     }
 }

sample/src/main/java/ru/terrakok/cicerone/sample/ui/bottom/BottomNavigationActivity.java

@@ -130,8 +130,8 @@ private void initContainers() {
     }
 
     @Override
-    protected void onResume() {
-        super.onResume();
+    protected void onResumeFragments() {
+        super.onResumeFragments();
         navigatorHolder.setNavigator(navigator);
     }
 

sample/src/main/java/ru/terrakok/cicerone/sample/ui/main/MainActivity.java

@@ -81,8 +81,8 @@ protected void onCreate(@Nullable Bundle savedInstanceState) {
     }
 
     @Override
-    protected void onResume() {
-        super.onResume();
+    protected void onResumeFragments() {
+        super.onResumeFragments();
         navigatorHolder.setNavigator(navigator);
     }