persistent search view 다운로드 - persistent search view 소스 코드 다운로드

persistent search view

기타 소스코드

1.1.5

다운로드

영구 검색 보기

검색 관련 기능 구현 프로세스를 단순화하도록 설계된 안드로이드 라이브러리입니다.

내용물

데모
시작하기
기본 구현
기본적인 최근 제안사항 구현
기본 정기제안 이행
고급 사용
최근 추천과 일반 추천의 차이점
기부금
명예의 전당
특허

데모(유튜브)

시작하기

최상위 build.gradle 파일에 mavenCentral() 저장소를 추가했는지 확인하세요.

buildscript {
    // ...
    repositories {
        // ...
        mavenCentral()
    }
    // ...
}

모듈 수준 build.gradle 파일에 라이브러리 종속성을 추가합니다.

dependencies {
    implementation " com.paulrybitskyi.persistentsearchview:persistentsearchview:1.1.5 "
}

targetSdk 가 30 이고 음성 검색 기능을 사용하려면 앱의 AndroidManifest.xml 에 다음 줄을 추가하세요.

< manifest ...>

    //...
    < queries >
        < intent >
            < action android : name = " android.speech.RecognitionService " />
        </ intent >
    </ queries >
    //...

</ manifest >

자신만의 검색 보기 구현을 진행하세요.

기본 구현

기본 기능을 갖춘 PertantSearchView 구현에는 선택한 XML 파일 내에서 위젯을 선언하고 Java/Kotlin 클래스 중 하나에서 위젯을 구성하는 두 가지 주요 단계가 포함됩니다.

위에 나열된 단계에 따라 기본 기능을 갖춘 PertantSearchView를 구현해 보겠습니다.

XML 파일 내에서 위젯을 선언합니다.

XML(확대하려면 클릭)

<? xml version = " 1.0 " encoding = " utf-8 " ?>
< RelativeLayout
    xmlns : android = " http://schemas.android.com/apk/res/android "
    xmlns : app = " http://schemas.android.com/apk/res-auto "
    android : layout_width = " match_parent "
    android : layout_height = " match_parent " >

    <!-- Other widgets here -->

    < com .paulrybitskyi.persistentsearchview.PersistentSearchView
        android : id = " @+id/persistentSearchView "
        android : layout_width = " match_parent "
        android : layout_height = " wrap_content "
        android : paddingTop = " 4dp "
        android : paddingLeft = " 4dp "
        android : paddingStart = " 4dp "
        android : paddingRight = " 4dp "
        android : paddingEnd = " 4dp " />

</ RelativeLayout >

Java/Kotlin 클래스 중 하나에서 위젯을 구성합니다.

Kotlin(확대하려면 클릭)

 override fun onCreate ( savedInstanceState : Bundle ? ) {
    super .onCreate(savedInstanceState)
    setContentView( R .layout.demo_activity_layout)

    // ...

    with (persistentSearchView) {
        setOnLeftBtnClickListener {
            // Handle the left button click
        }
        setOnClearInputBtnClickListener {
            // Handle the clear input button click
        }

        // Setting a delegate for the voice recognition input
        setVoiceRecognitionDelegate( VoiceRecognitionDelegate ( this @DemoActivity))

        setOnSearchConfirmedListener { searchView, query ->
            // Handle a search confirmation. This is the place where you'd
            // want to perform a search against your data provider.
        }

        // Disabling the suggestions since they are unused in
        // the simple implementation
        setSuggestionsDisabled( true )
    }
}


// ...


override fun onActivityResult ( requestCode : Int , resultCode : Int , data : Intent ? ) {
    super .onActivityResult(requestCode, resultCode, data)

    // Calling the voice recognition delegate to properly handle voice input results
    VoiceRecognitionDelegate .handleResult(persistentSearchView, requestCode, resultCode, data)
}

자바(확대하려면 클릭)

 @ Override
protected void onCreate ( Bundle savedInstanceState ) {
    super . onCreate ( savedInstanceState );
    setContentView ( R . layout . demo_activity_layout );

    //...

    persistentSearchView . setOnLeftBtnClickListener ( new OnClickListener () {

        @ Override
        public void onClick ( View view ) {
            // Handle the left button click
        }

    });

    persistentSearchView . setOnClearInputBtnClickListener ( new OnClickListener () {

        @ Override
        public void onClick ( View view ) {
            // Handle the clear input button click
        }

    });

    // Setting a delegate for the voice recognition input
    persistentSearchView . setVoiceRecognitionDelegate ( new VoiceRecognitionDelegate ( this ));

    persistentSearchView . setOnSearchConfirmedListener ( new OnSearchConfirmedListener () {

        @ Override
        public void onSearchConfirmed ( PersistentSearchView searchView , String query ) {
            // Handle a search confirmation. This is the place where you'd
            // want to perform a search against your data provider.
        }

    });

    // Disabling the suggestions since they are unused in
    // the simple implementation
    persistentSearchView . setSuggestionsDisabled ();
}


//...


@ Override
protected fun onActivityResult ( int requestCode , int resultCode , Intent data ) {
    super . onActivityResult ( requestCode , resultCode , data );

    // Calling the voice recognition delegate to properly handle voice input results
    VoiceRecognitionDelegate . handleResult ( persistentSearchView , requestCode , resultCode , data );
}

기본적인 최근 제안사항 구현

최근 제안이 포함된 PertantSearchView 구현은 보기 구성이라는 한 가지 예외를 제외하면 기본 구현과 거의 동일합니다.

이 구현에서는 사용자에게 최근 제안을 표시하기 위해 위젯에 대해 좀 더 많은 구성을 제공해야 합니다. 예를 들어 몇 명의 리스너에 대한 구현을 제공하고 데이터 공급자로부터 제안을 가져와서 검색으로 설정해야 합니다. 보다.

예를 들어 최근 제안 기능이 포함된 위젯 구성은 다음과 같습니다.

자바(확대하려면 클릭)

 @ Override
protected void onCreate ( Bundle savedInstanceState ) {
    super . onCreate ( savedInstanceState );
    setContentView ( R . layout . demo_activity_layout );

    //...

    persistentSearchView . setOnLeftBtnClickListener ( new OnClickListener () {
        
        @ Override
        public void onClick ( View view ) {
            // Handle the left button click
        }

    });

    persistentSearchView . setOnClearInputBtnClickListener ( new OnClickListener () {
        
        @ Override
        public void onClick ( View view ) {
            // Handle the clear input button click
        }

    });

    // Setting a delegate for the voice recognition input
    persistentSearchView . setVoiceRecognitionDelegate ( new VoiceRecognitionDelegate ( this ));

    persistentSearchView . setOnSearchConfirmedListener ( new OnSearchConfirmedListener () {

        @ Override
        public void onSearchConfirmed ( PersistentSearchView searchView , String query ) {
            // Handle a search confirmation. This is the place where you'd
            // want to save a new query and perform a search against your
            // data provider.
        }

    });

    persistentSearchView . setOnSearchQueryChangeListener ( new OnSearchQueryChangeListener () {
        
        @ Override
        public void onSearchQueryChanged ( PersistentSearchView searchView , String oldQuery , String newQuery ) {
            // Handle a search query change. This is the place where you'd
            // want load new suggestions based on the newQuery parameter.
        }

    });

    persistentSearchView . setOnSuggestionChangeListener ( new OnSuggestionChangeListener () {

        @ Override
        public void onSuggestionPicked ( SuggestionItem suggestion ) {
            // Handle a suggestion pick event. This is the place where you'd
            // want to perform a search against your data provider.
        }

        @ Override
        public void onSuggestionRemoved ( SuggestionItem suggestion ) {
            // Handle a suggestion remove event. This is the place where
            // you'd want to remove the suggestion from your data provider.
        }

    });
}
	

//...


@ Override
public void onResume () {
    super . onResume ();

    List < String > searchQueries = null ;

    // Fetching the search queries from the data provider
    if ( persistentSearchView . isInputQueryEmpty ) {
        searchQueries = mDataProvider . getInitialSearchQueries ();
    } else {
        searchQueries = mDataProvider . getSuggestionsForQuery ( persistentSearchView . inputQuery );
    }

    // Converting them to recent suggestions and setting them to the widget
    persistentSearchView . setSuggestions ( SuggestionCreationUtil . asRecentSearchSuggestions ( searchQueries ), false );
}

	
//...


@ Override
protected fun onActivityResult ( int requestCode , int resultCode , Intent data ) {
    super . onActivityResult ( requestCode , resultCode , data );

    // Calling the voice recognition delegate to properly handle voice input results
    VoiceRecognitionDelegate . handleResult ( persistentSearchView , requestCode , resultCode , data );
}

Kotlin(확대하려면 클릭)

 override fun onCreate ( savedInstanceState : Bundle ? ) {
    super .onCreate(savedInstanceState)
    setContentView( R .layout.demo_activity_layout)

    // ...

    with (persistentSearchView) {
        setOnLeftBtnClickListener {
            // Handle the left button click
        }
        setOnClearInputBtnClickListener {
            // Handle the clear input button click
        }

        // Setting a delegate for the voice recognition input
        setVoiceRecognitionDelegate( VoiceRecognitionDelegate ( this @DemoActivity))

        setOnSearchConfirmedListener { searchView, query ->
            // Handle a search confirmation. This is the place where you'd
            // want to save a new query and perform a search against your
            // data provider.
        }

        setOnSearchQueryChangeListener { searchView, oldQuery, newQuery ->
            // Handle a search query change. This is the place where you'd
            // want load new suggestions based on the newQuery parameter.
        }

        setOnSuggestionChangeListener( object : OnSuggestionChangeListener {

            override fun onSuggestionPicked ( suggestion : SuggestionItem ) {
                // Handle a suggestion pick event. This is the place where you'd
                // want to perform a search against your data provider.
            }

            override fun onSuggestionRemoved ( suggestion : SuggestionItem ) {
                // Handle a suggestion remove event. This is the place where
                // you'd want to remove the suggestion from your data provider.
            }

        })
    }
}


// ...


override fun onResume () {
    super .onResume()

    // Fetching the search queries from the data provider
    val searchQueries = if (persistentSearchView.isInputQueryEmpty) {
        mDataProvider.getInitialSearchQueries()
    } else {
        mDataProvider.getSuggestionsForQuery(persistentSearchView.inputQuery)
    }

    // Converting them to recent suggestions and setting them to the widget
    persistentSearchView.setSuggestions( SuggestionCreationUtil .asRecentSearchSuggestions(searchQueries), false )
}


// ...


override fun onActivityResult ( requestCode : Int , resultCode : Int , data : Intent ? ) {
    super .onActivityResult(requestCode, resultCode, data)

    // Calling the voice recognition delegate to properly handle voice input results
    VoiceRecognitionDelegate .handleResult(persistentSearchView, requestCode, resultCode, data)
}

기본 정기제안 이행

일반 제안이 포함된 PertantSearchView 구현은 한 가지 예외를 제외하고 기본 최근 제안 구현과 동일합니다. 제안 생성 방법 asRecentSearchSuggestions(searchQueries)는 asRegularSearchSuggestions(searchQueries)로 대체되어야 합니다.