base on A community-driven replacement for JSQMessagesViewController <p align="center"> <img src="https://raw.githubusercontent.com/MessageKit/MessageKit/master/Assets/mklogo.png" title="MessageKit logo" width="270"> </p> <p align="center"> A community-driven replacement for JSQMessagesViewController </p> <p align="center"> <a href="https://swiftpackageindex.com/MessageKit/MessageKit"> <img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FMessageKit%2FMessageKit%2Fbadge%3Ftype%3Dswift-versions"/> <a href="https://swiftpackageindex.com/MessageKit/MessageKit"> <img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FMessageKit%2FMessageKit%2Fbadge%3Ftype%3Dplatforms"/> <a href="https://developer.apple.com/xcode"> <img src="https://img.shields.io/badge/Xcode-13-blue.svg" alt="Xcode"> </a> <a href="./LICENSE.md"> <img src="https://img.shields.io/github/license/MessageKit/MessageKit?color=red" alt="MIT"> </a> <a href="https://github.com/MessageKit/MessageKit/issues"> <img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat" alt="Contributions Welcome"> </a> </p> <br> <p align="center"> <img src="https://raw.githubusercontent.com/MessageKit/MessageKit/master/Assets/TypingIndicator.png" title="MessageKit header" width="400"> </p> ## Goals - Provide a :rotating_light:safe:rotating_light: environment for others to learn and grow through Open Source. - Make adding Chat:speech_balloon: to a project easy. - Enable beautiful and customizable Chat UI's. - Provide an awesome Open Source project for the iOS open source community. - Help others learn. ## Installation ### [Swift Package Manager](https://swift.org/package-manager/) - **Recommended** Swift 5.3 in Xcode 12 [added support](https://github.com/apple/swift-evolution/blob/master/proposals/0271-package-manager-resources.md) for assets in Swift Packages. You can [just add](https://developer.apple.com/documentation/xcode/adding_package_dependencies_to_your_app) MessageKit package to your project by entering it's repository URL ``` https://github.com/MessageKit/MessageKit ``` Older versions of Swift and Xcode don't support MessageKit via SPM. ### [Manual](https://github.com/MessageKit/MessageKit/blob/master/Documentation/MANUAL_INSTALLATION.md) ## Requirements - **iOS 14** or later - **Swift 6** or later > For iOS 13 or Swift 5.x please use version 4.3.0 > For iOS 12 or CocoaPods please use version 3.8.0 > For iOS 11 please use version 3.3.0 > For iOS 9 and iOS 10 please use version 3.1.1 ## Getting Started Please have a look at the [Quick Start guide](https://github.com/MessageKit/MessageKit/blob/master/Documentation/QuickStart.md) and the [FAQs](https://github.com/MessageKit/MessageKit/blob/master/Documentation/FAQs.md). We recommend you start by looking at the [Example](https://github.com/MessageKit/MessageKit/tree/master/Example) project or write a question with the "messagekit" tag on [Stack Overflow](https://stackoverflow.com/questions/tagged/messagekit). You can also look at previous issues here on GitHub with the **"Question"** tag. For more on how to use the MessageInputBar, see the dependency it is based on [InputBarAccessoryView](https://github.com/nathantannar4/InputBarAccessoryView). You can also see this [short guide]([https://github.com/MessageKit/MessageKit/blob/master/Documentation/MessageInputBar.md) Check out the full documentation [here](https://messagekit.github.io/MessageKit/documentation/messagekit). ### Cell Structure <p> <img src="https://raw.githubusercontent.com/MessageKit/MessageKit/master/Assets/CellStructure.png" title="CellStructure"> </p> Each default cell is a subclass of [`MessageContentCell`](https://github.com/MessageKit/MessageKit/blob/master/Sources/Views/Cells/MessageContentCell.swift) which has 7 parts. From top down we have a: `cellTopLabel`, `messageTopLabel`, `messageContainerView`, `messageBottomLabel`, `cellBottomLabel` with the `avatarView` and `accessoryView` on either side respectively. Above we see the basic [`TextMessageCell`](https://github.com/MessageKit/MessageKit/blob/master/Sources/Views/Cells/TextMessageCell.swift) which uses a `MessageLabel` as its main content. This structure will allow you to create a layout that suits your needs as you can customize the size, appearance and padding of each. If you need something more advanced you can implement a custom cell, which we show how to do in the [Example](https://github.com/MessageKit/MessageKit/tree/master/Example) project. ### InputBarAccessoryView Structure <p> <img src="https://raw.githubusercontent.com/MessageKit/MessageKit/master/Assets/InputBarAccessoryViewLayout.png" title="InputBarAccessoryViewLayout"> </p> The `InputBarAccessoryView`, 3rd party dependency from [InputBarAccessoryView](https://github.com/nathantannar4/InputBarAccessoryView) is a flexible and robust way of creating any kind of input layout you wish. Check the repo and examples there for more info. ## Default Cells <p> <img src="https://raw.githubusercontent.com/MessageKit/MessageKit/master/Assets/ExampleA.png" title="Example A" height=400> <img src="https://raw.githubusercontent.com/MessageKit/MessageKit/master/Assets/ExampleB.png" title="Example B" height=400> </p> The type of cell rendered for a given message is based on the `MessageKind` ```swift public enum MessageKind { case text(String) // TextMessageCell case attributedText(NSAttributedString) // TextMessageCell case photo(MediaItem) // MediaMessageCell case video(MediaItem) // MediaMessageCell case location(LocationItem) // LocationMessageCell case emoji(String) // TextMessageCell case audio(AudioItem) // AudioMessageCell case contact(ContactItem) // ContactMessageCell case linkPreview(LinkItem) // LinkPreviewMessageCell /// A custom message. /// - Note: Using this case requires that you implement the following methods and handle this case: /// - MessagesDataSource: customCell(for message: MessageType, at indexPath: IndexPath, in messagesCollectionView: MessagesCollectionView) -> UICollectionViewCell /// - MessagesLayoutDelegate: customCellSizeCalculator(for message: MessageType, at indexPath: IndexPath, in messagesCollectionView: MessagesCollectionView) -> CellSizeCalculator case custom(Any?) } ``` If you choose to use the `.custom` kind you are responsible for all of the cells layout. Any `UICollectionViewCell` can be returned for custom cells which means any of the styling you provide from the `MessageDisplayDelegate` will not effect your custom cell. Even if you subclass your cell from `MessageContentCell`. [Read more about custom cells](https://github.com/MessageKit/MessageKit/blob/master/Documentation/CUSTOM_CELLS.md) [Read more about the cases on the Quick Start guide.](https://github.com/MessageKit/MessageKit/blob/master/Documentation/QuickStart.md#messagekind) ## Contributing [](https://github.com/MessageKit/MessageKit/actions?query=workflow%3A%22Tests%22) [](https://github.com/MessageKit/MessageKit/actions?query=workflow%3A%22Build+Framework%22) [](https://github.com/MessageKit/MessageKit/actions?query=workflow%3A%22PR+Example+app%22) [](https://github.com/MessageKit/MessageKit/actions?query=workflow%3A%22Danger%22) Great! Look over these things first. - Please read our [Code of Conduct](https://github.com/MessageKit/MessageKit/blob/master/CODE_OF_CONDUCT.md) - Check the [Contributing Guide Lines](https://github.com/MessageKit/MessageKit/blob/master/CONTRIBUTING.md). - Come join us on [Slack](https://join.slack.com/t/messagekit/shared_invite/zt-2484ymok0-O82~1EtnHALSngQvn6Xwyw) and 🗣 don't be a stranger. - Check out the [current issues](https://github.com/MessageKit/MessageKit/issues) and see if you can tackle any of those. - Download the project and check out the current code base. Suggest any improvements by opening a new issue. - Check out the [What's Next](#whats-next) section :point_down: to see where we are headed. - Check [StackOverflow](https://stackoverflow.com/questions/tagged/messagekit) - Install [SwiftLint](https://github.com/realm/SwiftLint) to keep yourself in :neckbeard: style. - Be kind and helpful. ## What's Next? Check out the [Releases](https://github.com/MessageKit/MessageKit/releases) to see what we are working on next. ## Contact Have a question or an issue about MessageKit? Create an [issue](https://github.com/MessageKit/MessageKit/issues/new)! Interested in contributing to MessageKit? Click here to join our [Slack](https://join.slack.com/t/messagekit/shared_invite/MjI4NzIzNzMyMzU0LTE1MDMwODIzMDUtYzllYzIyNTU4MA). ### Apps using this library Add your app to the list of apps using this library and make a pull request. - [ClassDojo](https://www.classdojo.com) - [Coursicle](https://apps.apple.com/us/app/coursicle/id1187418307) - [Connect Messaging](https://apps.apple.com/app/id1607268774) - [Ring4](https://www.ring4.com) - [Formacar](https://itunes.apple.com/ru/app/id1180117334) - [HopUp](https://itunes.apple.com/us/app/hopup-airsoft-community/id1128903141?mt=8) - [MediQuo](https://www.mediquo.com) - [RappresentaMe](https://itunes.apple.com/it/app/rappresentame/id1330914443) - [WiseEyes](https://itunes.apple.com/us/app/wiseeyes/id1391408511?mt=8) - [SwiftHub](https://github.com/khoren93/SwiftHub) - [Studievenn](https://studievenn.no) - [SmooveText](https://apps.apple.com/np/app/smoove-text/id1362792811) - [COYO Engage](https://apps.apple.com/app/coyo-engage/id1341588804) - [HitchPin](https://www.hitchpin.com) - [Charge Running](https://apps.apple.com/app/charge-running-live-coaching/id1204578360) - [HER](https://apps.apple.com/us/app/id573328837) - [Girlfriend Plus](https://apps.apple.com/us/app/girlfriend-plus/id1011637655) - [Noon Happen](https://apps.apple.com/app/id1477310602) - [XPASS](https://apps.apple.com/cz/app/id1596773834) - [HeiaHeia](https://www.heiaheia.com) - [Starstruck AI](https://apps.apple.com/au/app/starstruck-message-anyone/id6446234281) - [OutyPlay](https://apps.apple.com/app/id6450551793) _Please provide attribution, it is greatly appreciated._ ## Core Team - [@SD10](https://github.com/sd10), Steven Deutsch - [@nathantannar4](https://github.com/nathantannar4), Nathan Tannar - [@zhongwuzw](https://github.com/zhongwuzw), Wu Zhong - [@austinwright](https://github.com/austinwright), Austin Wright - [@kaspik](https://github.com/kaspik), Jakub Kaspar - [@martinpucik](https://github.com/martinpucik), Martin Pucik ## Thanks Many thanks to [**the contributors**](https://github.com/MessageKit/MessageKit/graphs/contributors) of this project. ## License MessageKit is released under the [MIT License](https://github.com/MessageKit/MessageKit/blob/master/LICENSE.md). ## Inspiration Inspired by [JSQMessagesViewController](https://github.com/jessesquires/JSQMessagesViewController) :point_left: :100: ", Assign "at most 3 tags" to the expected json: {"id":"11122","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"