Hi there, I'm trying to add this library into my app and for some reason it is not letting me add this.

Here's my app's build.gradle:

apply plugin: 'com.android.application'

android {
    compileSdkVersion 21
    buildToolsVersion "21.1.2"

defaultConfig {
    applicationId "com.mstar.hotmaps"
    minSdkVersion 16
    targetSdkVersion 21
    versionCode 1
    versionName "1.0"
   }
   buildTypes {
    release {
        minifyEnabled false
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
  }
}

dependencies {
  compile fileTree(dir: 'libs', include: ['*.jar'])
  testCompile 'junit:junit:4.12'
  compile 'com.android.support:appcompat-v7:22.2.1'
  compile 'com.google.android.gms:play-services:7.8.0'
  compile ('com.github.worker8.tourguide:1.0.13-SNAPSHOT@aar'){
      transitive=true
  }
}

Is there anything I'm missing?

Thanks.

In samples you use some: ChainTourGuide but there is no source code or implementation of it.

Same when I use dependencies: com.github.worker8:tourguide:1.0.16-SNAPSHOT@aar

i loved this tour guide, thx worker8!

sorry the silly question, i know how to add the next button to the layout, but it get "darker", thats because the overlay color to make a "disabled screen" and give lighting to where the pointer is. How can i make the button above/below the tooltip or another position but without getting dark, i tried adding another tourguide just to the button, but it add another "darker" to all the layout making the white pointer a little gray..

or is there another "good" approach for handling the tooltip in sequence and i dont know?

and about the icon problem, when i add the tourguide to the gradle, my manifest get a conflict:

android:icon="myicon"is also present at com.github.worker8:tourguide:1.0.10-SNAPSHOT:13:9 value=(@drawable/ic_launcher1)

i already tried the android:replace icon but without results

not related to the problem, but it was like I was doing:

1. User open the app for the first time(check the SharedPrefs)
2. Load a new TourGuide to the first element i want to teach and add the button next in the middle of the screen
3. for each click on the button call a function called nextTip() and for each click it do a tipCount++; and inside the function nextTip() it check the number and set the actual tour to a new TourGuide... related to the position(after a cleanUp() ofc)

thats the correct approach or there is a kind of actualTour.addTour(new TourGuide...) and some kind of actualTour.displayNextTour();

thx the nice tourGuide ;)

This can be done via toolTip.setLayout(int resource, Context context).

The layout is validated for existence of its basic components, so that the currently-existing setters still work.

Please let me know your thoughts on this!

Thanks

When using passing an AnimationSet to setExitAnimation for an Overlay, Android would throw a NullPointerException when the overlay View was to be removed. E.g.

09-02 11:08:17.643  19897-19897/tourguide.tourguide E/AndroidRuntime﹕ FATAL EXCEPTION: main
    Process: tourguide.tourguide, PID: 19897
    java.lang.NullPointerException: Attempt to read from field 'int android.view.View.mViewFlags' on a null object reference
            at android.view.ViewGroup.dispatchDraw(ViewGroup.java:3197)
            at android.view.View.updateDisplayListIfDirty(View.java:14162)
            at android.view.View.getDisplayList(View.java:14189)
            at android.view.ViewGroup.recreateChildDisplayList(ViewGroup.java:3389)
            at android.view.ViewGroup.dispatchGetDisplayList(ViewGroup.java:3368)
            at android.view.View.updateDisplayListIfDirty(View.java:14127)
            at android.view.View.getDisplayList(View.java:14189)
            at android.view.ViewGroup.recreateChildDisplayList(ViewGroup.java:3389)
            at android.view.ViewGroup.dispatchGetDisplayList(ViewGroup.java:3368)
            at android.view.View.updateDisplayListIfDirty(View.java:14127)
            at android.view.View.getDisplayList(View.java:14189)
            at android.view.ViewGroup.recreateChildDisplayList(ViewGroup.java:3389)
            at android.view.ViewGroup.dispatchGetDisplayList(ViewGroup.java:3368)
            at android.view.View.updateDisplayListIfDirty(View.java:14127)
            at android.view.View.getDisplayList(View.java:14189)
            at android.view.View.draw(View.java:14959)
            at android.view.ViewGroup.drawChild(ViewGroup.java:3405)
            at android.view.ViewGroup.dispatchDraw(ViewGroup.java:3198)
            at android.view.View.draw(View.java:15234)
            at android.widget.FrameLayout.draw(FrameLayout.java:598)
            at com.android.internal.policy.impl.PhoneWindow$DecorView.draw(PhoneWindow.java:2650)
            at android.view.View.updateDisplayListIfDirty(View.java:14167)
            at android.view.View.getDisplayList(View.java:14189)
            at android.view.ThreadedRenderer.updateViewTreeDisplayList(ThreadedRenderer.java:273)
            at android.view.ThreadedRenderer.updateRootDisplayList(ThreadedRenderer.java:279)
            at android.view.ThreadedRenderer.draw(ThreadedRenderer.java:318)
            at android.view.ViewRootImpl.draw(ViewRootImpl.java:2530)
            at android.view.ViewRootImpl.performDraw(ViewRootImpl.java:2352)
            at android.view.ViewRootImpl.performTraversals(ViewRootImpl.java:1982)
            at android.view.ViewRootImpl.doTraversal(ViewRootImpl.java:1061)
            at android.view.ViewRootImpl$TraversalRunnable.run(ViewRootImpl.java:5885)
            at android.view.Choreographer$CallbackRecord.run(Choreographer.java:767)
            at android.view.Choreographer.doCallbacks(Choreographer.java:580)
            at android.view.Choreographer.doFrame(Choreographer.java:550)
            at android.view.Choreographer$FrameDisplayEventReceiver.run(Choreographer.java:753)
            at android.os.Handler.handleCallback(Handler.java:739)
            at android.os.Handler.dispatchMessage(Handler.java:95)
            at android.os.Looper.loop(Looper.java:135)
            at android.app.ActivityThread.main(ActivityThread.java:5254)
            at java.lang.reflect.Method.invoke(Native Method)
            at java.lang.reflect.Method.invoke(Method.java:372)
            at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:903)
            at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:698)

This commit fixes the problem using a post call on the overlay View.

http://stackoverflow.com/questions/3025163/how-to-remove-a-view-when-animation-ends discusses this problem in a bit more detail.

Hi there, what a remarkable lib)

When the view that's inside playOn() is pressed, the tooltip, pointer and overlay dont' go away.

So, i was wondering is there any other way to touch a tooltip and dismiss it somehow so that perhaps you move to the next step of your tour guide?

i wanted to use this library, however there are a lot of things missing for a regular use case. I give you a short list, if that is okay :)

• If i enter more than a few words the tooltip expands beyond the screen borders. It shold automatically break the lines if necessary. A simple check if the screen boundaries are reached would be good.
• The overlay is not alway exactly where i want it, e.g. i have an icon and the overlay is a little bit misplaced around it. so it would be good to be able to "adjust" its position and size through some relative value like "+=3dp" (add 3dp to the size, or move it 3dp to the left)...
• Chaining of tourguides. Is this planned, how do i do it currently? e.g. i want the user first to click here, then there, and then here.
• Option to just show the tourGuide without user interaction --> Let it close itself after the user clicked SOMEHWHERE on the Screen.

BTW: Great work nevertheless, really looking forward to this library as the de facto standard for "overlay-helping-tour-guides"

When using the tourguide on a fullscreen ui, with the navigation and status bars hidden, the framelayoutwithhole view does not cover the area behind the navigation bar. DisplayMetrics is used to get the screen size but it does not return the actual raw pixel dimensions of the screen. Use a different method to get the screen size.

Hi, I am preparing one demo application for I am using this library for guiding. In my App I also want user to have look at alert dialog So I want tourGuide on Alert Dialog.

Can you help me how do I archive this.?

I am trying the same code but it show behind alert dialog.

Hi, I am using fragment in my activity. I am trying to create a tutorial for a fragment screen but somehow the the view being highlighted is not the correct one. I am iniating the Tourguide code in onViewCreated function of the fragment. Is it something I am missing considerably.

The main goal of this PR is to remove the unused app_name string from the library module.

The problem happens when the library is added into a project, and app_name is not defined is the root module. In that case, gradle doesn't know which definition of app_name is more important, so it might device to use Tour Guide as app_name :(

app_name is unused anyway, so I thought I could remove it to avoid confusion.

As for ic_launcher1, I just saw it was unused so I thought it's be ok to remove it to avoid conflicts and save some space.

note: tests run ok in my machine

I see that you changed the library language to kotlin, years back, but, I was using the java version of the same. Please point me to the java branch where I can still find the library and use in my project, a zip will do the job for me.

Thanks

I am trying to use TourGuide on Wear OS. The tooltip does not appear the first time I use the "PlayOn" function but does the second time. Here is my code:

`final TourGuide tourGuide = TourGuide.init(activity).with(TourGuide.Technique.CLICK); ToolTip toolTip = new ToolTip(); toolTip.setGravity(Gravity.TOP); toolTip.setDescription("Click description"); Overlay overlay = new Overlay(); overlay.setMDisableClickThroughHole(true); overlay.setMStyle(Overlay.Style.CIRCLE);

                overlay.setOnClickListener(view -> {
                    tourGuide.cleanUp();
                    clicks++;
                    if(clicks == 1) {
                        tourGuide.playOn(episodeFragment.findViewById(R.id.play_button));
                    }
                });

        Pointer downloadPointer = new Pointer(Gravity.CENTER);
        tourGuide.setPointer(downloadPointer)
                .setToolTip(toolTip)
                .setOverlay(overlay);
        tourGuide.playOn(episodeFragment.findViewById(R.id.play_button));`