Unduh material intro - unduh kode sumber material intro

materi-intro

Intro aplikasi desain material sederhana dengan animasi keren dan API yang lancar.

Sangat terinspirasi oleh intro aplikasi Google.

Demo:

Aplikasi demo tersedia di Google Play:

Tangkapan layar:

Geser sederhana	Geser khusus	Efek memudar	Permintaan izin

`SimpleSlide.java`	`FragmentSlide.java`	`IntroActivity.java`	`SimpleSlide.java`

Fitur:

Desain material (periksa dokumen)
Kustomisasi yang mudah
Tata letak slide yang telah ditentukan sebelumnya
Slide khusus
Putar otomatis
Slide paralaks
API yang Lancar

Daftar isi

Pengaturan
1. Ketergantungan Gradle
2. Persyaratan
Slide
1. Perosotan standar
2. Slide fragmen
3. Geser khusus
Kustomisasi
1. Tombol kembali
2. Tombol berikutnya
3. tombol CTA
4. Layar penuh
5. Durasi gulir
Navigasi
1. Blokir navigasi
2. Navigasi ke slide
3. Putar otomatis
4. Panggilan balik
Tip & Trik
1. Hasil kegiatan
2. Slide paralaks
3. Layar pembuka
Aplikasi yang menggunakan perpustakaan ini
Perubahan
Perpustakaan sumber terbuka
Lisensi

Pengaturan:

Ketergantungan Gradle:

materi-intro tersedia di jitpack.io .

Tambahkan ini di file root build.gradle Anda ( bukan file build.gradle modul Anda):

 allprojects {
    repositories {
        maven { url ' https://jitpack.io ' }
    }
}

Tambahkan ini di file build.gradle modul Anda:

 dependencies {
    implementation ' com.heinrichreimersoftware:material-intro:x.y.z '
}

Persyaratan:

Aktivitas harus memperluas IntroActivity dan memiliki tema yang diperluas @style/Theme.Intro :

 public class MainIntroActivity extends IntroActivity {
    @ Override 
    protected void onCreate ( Bundle savedInstanceState ) {
        super . onCreate ( savedInstanceState );
	    // Add slides, edit configuration...
    }
}

< manifest ...>
    < application ...>
        < activity 
            android : name = " .MainIntroActivity "
            android : theme = " @style/Theme.Intro " />
    </ application >
</ manifest >

(Kecuali disebutkan sebaliknya, semua pemanggilan metode berikut harus dilakukan di onCreate() Aktivitas.)

Slide:

material-intro memiliki pembuat gaya yang lancar untuk slide teks/gambar sederhana, seperti yang terlihat di aplikasi Google, dan untuk slide yang menampilkan Fragment khusus atau sumber daya tata letak.

Jangan ragu untuk mengirimkan masalah atau permintaan penarikan jika menurut Anda ada jenis slide yang hilang.

Slide standar ( `SimpleSlide` ):

Slide standar menampilkan judul, deskripsi singkat, dan gambar seperti intro Google.

 addSlide ( new SimpleSlide . Builder ()
        . title ( R . string . title_1 )
        . description ( R . string . description_1 )
        . image ( R . drawable . image_1 )
        . background ( R . color . background_1 )
        . backgroundDark ( R . color . background_dark_1 )
        . scrollable ( false )
        . permission ( Manifest . permission . CAMERA )
        . build ());

Slide fragmen ( `FragmentSlide` ):

Slide khusus yang berisi Fragment atau sumber daya tata letak.

 addSlide ( new FragmentSlide . Builder ()
        . background ( R . color . background_2 )
        . backgroundDark ( R . color . background_dark_2 )
        . fragment ( R . layout . fragment_2 , R . style . FragmentTheme )
        . build ());

(Saat menggunakan FragmentSlide dengan Fragment , Anda harus memperluas SlideFragment ke panggilan navigasi proxy ke aktivitas intro.)

Slide khusus ( `Slide` ):

Perosotan dasar. Jika Anda ingin mengubah apa yang ditampilkan di slide Anda, inilah caranya.

Kustomisasi:

Tombol kiri ("kembali"):

Kontrol perilaku tombol kiri atau sembunyikan/tampilkan.

 /* Show/hide button */
setButtonBackVisible ( true );
/* Use skip button behavior */
setButtonBackFunction ( BUTTON_BACK_FUNCTION_SKIP );
/* Use back button behavior */
setButtonBackFunction ( BUTTON_BACK_FUNCTION_BACK );

Tombol kanan ("berikutnya"):

Kontrol perilaku tombol kanan atau sembunyikan/tampilkan.

 /* Show/hide button */
setButtonNextVisible ( true );
/* Use next and finish button behavior */
setButtonNextFunction ( BUTTON_NEXT_FUNCTION_NEXT_FINISH );
/* Use next button behavior */
setButtonNextFunction ( BUTTON_NEXT_FUNCTION_NEXT );

Tombol CTA:

Mengubah tampilan tombol "ajakan bertindak":

 /* Show/hide button */
setButtonCtaVisible ( getStartedEnabled );
/* Tint button text */
setButtonCtaTintMode ( BUTTON_CTA_TINT_MODE_TEXT );
/* Tint button background */
setButtonCtaTintMode ( BUTTON_CTA_TINT_MODE_BACKGROUND );
/* Set custom CTA label */
setButtonCtaLabel ( R . string . start )
/**/
setButtonCtaClickListener ( new View . OnClickListener () {

});

Layar penuh:

Tampilkan aktivitas intro dalam layar penuh. Ini menyembunyikan bilah status.

 public class MainIntroActivity extends IntroActivity {
    @ Override protected void onCreate ( Bundle savedInstanceState ){
        setFullscreen ( true );
        super . onCreate ( savedInstanceState );
	...
    }
}

Pastikan untuk memanggil setFullscreen() sebelum memanggil super.onCreate()

Durasi gulir:

Sesuaikan berapa lama waktu yang dibutuhkan untuk satu pengguliran slide.

 setPageScrollDuration ( 500 );

(Durasi pengguliran halaman diadaptasi secara dinamis ketika menggulir lebih dari satu posisi untuk mencerminkan durasi dinamis dari dokumen desain Material. Rumus yang tepat untuk menghitung durasi pengguliran adalah duration * (distance + sqrt(distance)) / 2 .)

Navigasi:

Blokir navigasi:

Ada tiga cara untuk memblokir navigasi slide:

Dalam SlideFragment (menggunakan FragmentSlide ) dengan mengganti metode canGoForward() / canGoBackward() .
Untuk SimpleSlide dengan menyetel SimpleSlide.Builder#canGoForward(boolean) / SimpleSlide.Builder#canGoBackward(boolean) . (Jika setidaknya satu izin diatur ke SimpleSlide , navigasi secara otomatis diblokir hingga setiap izin diberikan.)

Dari IntroActivity Anda dengan menyetel NavigationPolicy :

 setNavigationPolicy ( new NavigationPolicy () {
    @ Override public boolean canGoForward ( int position ) {
        return true ;
    }

    @ Override public boolean canGoBackward ( int position ) {
        return false ;
    }
});

Navigasi ke slide

Navigasikan intro secara manual menggunakan salah satu metode berikut, misalnya dari callback pendengar. Masing-masing dari mereka akan menghormati pengaturan navigasi yang diblokir.

 /* Scroll to any position */
goToSlide ( 5 );

/* Scroll to the next slide in the intro */
nextSlide ();

/* Scroll to the previous slide in the intro */
previousSlide ();

/* Scroll to the last slide of the intro */
goToLastSlide ();

/* Scroll to the first slide of the intro */
goToFirstSlide ();

Putar otomatis

Gulir intro secara otomatis hingga pengguna berinteraksi dengan intro.

 /* Start an auto slideshow with 2500ms delay between scrolls and infinite repeats */
autoplay ( 2500 , INFINITE );
/* Start an auto slideshow with default configuration  */
autoplay ();
/* Cancel the slideshow */
cancelAutoplay ()

Panggilan balik

Jika salah satu jawaban di atas false saat pengguna mencoba menavigasi ke slide, panggilan balik OnNavigationBlockedListener diaktifkan yang dapat Anda gunakan untuk menampilkan pesan. Selain itu, Anda dapat menambahkan ViewPager.OnPageChangeListener biasa untuk mendengarkan gulungan halaman:

 addOnNavigationBlockedListener ( new OnNavigationBlockedListener () {
    @ Override public void onNavigationBlocked ( int position , int direction ) { ... }
});

addOnPageChangeListener ( new ViewPager . OnPageChangeListener (){
    @ Override public void onPageScrolled ( int position , float positionOffset , int positionOffsetPixels ) { ... }
    @ Override public void onPageSelected ( int position ) { ... }
    @ Override public void onPageScrollStateChanged ( int state ) { ... }
});

Tip & Trik:

Hasil kegiatan:

Anda dapat memeriksa apakah pengguna membatalkan intro (dengan menekan kembali) atau menyelesaikannya termasuk semua slide. Panggil saja aktivitas menggunakan startActivityForResult(intent, REQUEST_CODE_INTRO); lalu dengarkan hasilnya:

 @ Override
protected void onActivityResult ( int requestCode , int resultCode , Intent data ) {
    super . onActivityResult ( requestCode , resultCode , data );
    if ( requestCode == REQUEST_CODE_INTRO ) {
        if ( resultCode == RESULT_OK ) {
            // Finished the intro
        } else {
            // Cancelled the intro. You can then e.g. finish this activity too.
            finish ();
	}
    }
}

Slide paralaks:

Anda dapat dengan mudah mendapatkan efek paralaks yang terlihat bagus untuk slide apa pun dengan menggunakan ParallaxFrameLayout.java , ParallaxLinearLayout.java atau ParallaxRelativeLayout.java dan mendefinisikan layout_parallaxFactor untuk turunan langsungnya. Faktor yang lebih tinggi berarti efek paralaks lebih kuat, 0 berarti tidak ada efek paralaks sama sekali.

< com .heinrichreimersoftware.materialintro.view.parallax.ParallaxLinearLayout
    android : layout_width = " match_parent "
    android : layout_height = " match_parent "
    ... >

    < TextView
        android : layout_width = " match_parent "
        android : layout_height = " wrap_content "
        app : layout_parallaxFactor = " 0 "
        ... />

    < ImageView
        android : layout_width = " match_parent "
        android : layout_height = " wrap_content "
        app : layout_parallaxFactor = " 1.25 "
        ... />

</ com .heinrichreimersoftware.materialintro.view.parallax.ParallaxLinearLayout>

Periksa demo "Kantin" untuk contoh tata letak.

Layar pembuka:

Jika Anda ingin menampilkan intro hanya saat aplikasi pertama kali dimulai, Anda dapat menggunakan onActivityResult() untuk menyimpan preferensi bersama saat pengguna menyelesaikan intro.

Lihat aplikasi demo untuk contoh penerapan layar splash:

SplashActivity.java : Layar splash palsu
SplashIntroActivity.java : Intro dimulai dari FinishActivity
FinishActivity.java : Aktivitas dimulai setelah splash screen

Aplikasi yang menggunakan perpustakaan ini:

Cukup Unroot oleh @pinpong
Pemutar Musik Hilang oleh @SpongeBobSun
Utilitas Kata Sandi Puff oleh @SpongeBobSun
QualityGate oleh @FrontEndART
Pantau oleh @daniel-stoneuk
Waktu Lensa Kontak oleh @ste23droid
Penangkal Danmark oleh @AntidoteDanmark
Peningkatan Kecepatan Lite oleh @tjmille2
Pemeriksa Root oleh @joeykrim

Perubahan:

Lihat bagian rilis untuk log perubahan.

Perpustakaan sumber terbuka:

material-intro menggunakan file sumber terbuka berikut:

CheatSheet.java oleh @Roman Nurik (Lisensi Apache 2.0)
AnimUtils.java oleh @Nick Butcher (Lisensi Apache 2.0), versi modifikasi
InkPageIndicator.java oleh @Nick Butcher (Lisensi Apache 2.0)

Lisensi:

 MIT License

Copyright (c) 2017 Jan Heinrich Reimer

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Memperluas