kicklink is a command-line script crafted to simplify the sending of deeplinks on both Android and iOS platforms. It eliminates the need to memorize intricate adb
and xcrun
commands by introducing a consistent command-line interface for dispatching deeplinks to the respective platforms. Under the hood, it seamlessly directs deeplinks to Android devices using adb
and to iOS devices using xcrun
, all achieved with a single, easy-to-recall command.
Before installing kicklink, make sure you have the following prerequisites:
- Homebrew: If you don't have Homebrew installed, you can install it by following the instructions at https://brew.sh.
- adb
- XCode
Add new tap repository.
brew tap extmkv/brew
Install kicklink:
brew install kicklink
This will download and install the kicklink script on your system.
To use kicklink, you can run it from the command line with the following syntax:
kicklink -p [platform] -d [deeplink]
-p
: Specify the platform (android or ios). If not provided, it will dispatch to both Android and iOS.-d
: Specify the deeplink you want to dispatch.
Dispatch a deeplink to Android:
kicklink -p android -d myapp://example.com/page
Dispatch a deeplink to iOS:
kicklink -p ios -d myapp://example.com/page
Dispatch a deeplink to both Android and iOS:
kicklink -d myapp://example.com/page
You can view the help message by running:
kicklink -h
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
If you encounter any issues or have suggestions for improvement, please feel free to open an issue on this repository.
Happy deeplinking!