# injectable_generator 3.1.0 Injectable is a convenient code generator for get_it. Inspired by Angular DI, Guice DI and inject.dart. ## Installing ``` export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir flutter pub add 'injectable_generator:3.1.0' ``` Published: 2026-06-14T09:53:40.620417Z Expected archive SHA-256: f4489d28a0147d47fd9f16955fa62f84aab88a63e3b89418e6e2467c8e783e9a Available in cache; verification: upstream_checksum ## Direct dependencies - analyzer: >=10.0.0 <14.0.0 - build: ^4.0.4 - code_builder: ^4.11.0 - collection: ^1.18.0 - dart_style: ^3.1.4 - glob: ^2.1.3 - injectable: ^3.0.0 - lean_builder: ^1.2.0 - meta: ^1.16.0 - path: ^1.9.0 - recase: ^4.1.0 - source_gen: ^4.1.1 ## Package README (untrusted upstream documentation) # injectable_generator A generator for [injectable](https://pub.dev/packages/injectable) library. ## Changelog # ChangeLog ## [3.1.0] - Fix: avoid import alias collisions in HashedAllocator (#544) by @kmslab20 - Feat: support private named parameters by @jkoenig134 - Chore: update Dart SDK constraint to ">=3.12.0 <4.0.0" - Chore: update analyzer constraint to ">=10.0.0 <14.0.0" ## [3.0.2] - Fix: update lean_builder to 0.1.9 to sync analyzer version ## [3.0.1] - Fix: update lean_builder to 0.1.9 to sync analyzer version ## [3.0.0] - Breaking: Removed `includeMicroPackages` option. Micro packages must now be explicitly registered using `externalPackageModulesBefore` and `externalPackageModulesAfter` in `@InjectableInit`. - Breaking: Removed deprecated `usesNullSafety` option. Null safety is now always assumed. - Feat: Add support for multiple registrations via `allowMultipleRegistrations` (#535, #531). - Fix: Treat external dependencies as non-blocking in environment sorting (#539, Fixes #532). ## [2.12.1] - Chore: Update analyzer constrains to ">=9.0.0 <11.0.0" ## [2.12.0] - Feat: Add optional support for lean_builder package for blazing fast builds ## [2.11.1] - Feat: Add support for `generateAccessors` option to generate GetIt extension getters - Feat: Improve dependency sorting logic for more predictable registration order - Feat: Add comprehensive test coverage - Chore: Update injectable dependency to ^2.7.2 ## [2.11.0] - Feat: Add support to cached factories introduced in get_it 8.0.0 ## [2.10.0] - Chore: Update dependencies, analyzer (v9), glob (v2.1.3), code_builder (v4.11.0), dart_style (v3.1.3) ## [2.9.0] - Chore: Update dependencies, source_gen (v4), build (v4), analyzer (v8) - Update dart constrains to ">=3.8.0 <4.0.0" ## [2.8.1] - Fix: Fix @factoryMethod for factory class constructor ## [2.8.0] - Chore: Update dependencies, source_gen (v3), build (v3), build_runner (v2.6) - Feat: Add generateForEnvironments option - Fix: fex dependency sort when dependencies have multiple environments ## [2.7.0] - Chore: Update dependencies, source_gen (v2), analyzer (<8.0.0), dart_style (v3) ## [2.6.2] - Feat: Improve Code Generation consistency using hash in alias imports - Fix: Fix @preResolve only works for methods warning ## [2.6.1] Fix: make register order more predictable to avoid unnecessary code churns in source control by @Adam-Langley ## [2.6.0] Feat: add @ignoreParam annotation to ignore optional parameters in factory methods ## [2.5.1] Fix: Type Alias error on generation #437 ## [2.5.0] - Feat: add support for passing records as @factoryParam ## [2.4.2] - Fix Postpone singleton initialisation to respect environment filters by @lrampazzo ## [2.4.1] - Add option to pass instance callback function to the init function by @Adam-Langley ## [2.4.0] - Added [rootDir] support for specifying the root directory for the generation process. ## [2.3.0] - Revert: bumping up collection version to use 1.17.1 - Refactor: the main scope init method will now always be generated even if it has no dependencies ## [2.2.0] - Optimize injectable_generator async analysis by [https://github.com/Jjagg] - Update dart constrains to ">=3.0.0 <4.0.0" - Update analyzer constrains to include v6+ ## [2.1.6] - Fix const instances are not generated as consts - update dart constrains to ">=2.17.0 <4.0.0" - Upgrade some dependencies ## [2.1.5] - Add coverage:ignore-file comment to generated config - Fix relative imports not working - Update dependencies (codeBuilder, source_gen) ## [2.1.4] - Fix Scopes - class is registered more than once under the same environment #338 - Fix Injectable unable to detect dependencies from micropackages #341 ## [2.1.3] - Fix name of MicroPackageModule contains "_" (is not pascal case) #332 ## [2.1.2] - Fix registration order ## [2.1.1] - Fix barrel files related issue ## [2.1.0] - Add support for micro package modules order [before,after] - Add support for micro package modules scopes ## [2.0.1] - Fix registration order #324 ## [2.0.0] [Minor breaking changes] - Add support for micro packages - Add support for external package modules - Add support for manual dependencies ordering thanks to @casvanluijtelaar - Add support for GetIt scopes - Add @PostConstruct annotation to execute sync/async code after construction - Add preResolve to @FactoryMethod annotation - Add throwOnMissingDependencies flag to @InjectableInit annotation - Change asExtension default value to true [breaking change] - Change initializerName default value to 'init' [breaking change] ## [1.5.5] - Bump up analyzer version ## [1.5.4] - Bump up analyzer version ## [1.5.3] - Sync injectable and injectable_generator with GetIt v7.2.0 to generate non-nullable @factoryParams - Migrate to analyzer 3.0.0 ## [1.5.2] Fix yet another registration order issue #244 ## [1.5.1] Fix auto-async factory bug #237 Fix passing dispose function throws #240 Fix initialization order doesn't respect environments #238 Add generator prints warning when an injected dependency is not available under the same environment ## [1.5.0] Use getAsync for async injected dependencies, fixes #230 Add support for function factory params, fixes #224 Update analyzer version #228 Add ignore types in packages support Fix some readme typos ## [1.4.1] - Bump up build_runner version to 2.0.3 - Fix generator crash when using inline environments #205 ## [1.4.0] - Bump up get_it version to range to 7.0.0 <= 8.0.0 - Bump up build_runner version to 2.0.2 ## [1.3.0] - Include merge that fixes #194 - Bump up versions of build_runner -> 2.0.1, code_builder -> 4.0.0, analyzer -> 1.5.0 ## [1.2.2] - Fix generator crash after 1.2.1 update - Add option to ignore missing type warning for specified types ## [1.2.1] - Bump up versions of build, build_runner, dart_style and source_gen - Fix named instances are ignored when sorting dependencies. - Clean up some code ## [1.2.0] - push nullSafety version to the main section - Fix sorting by dependents ignores named instances ## [1.2.0-nullsafety] - add null safety support ## [1.1.2] - Add support for disposing of singletons. - change min version constraint of GetIt to 5.0.0 - update readme file ## [1.1.0] - Refactor code to support null-safety - Fix preResolved instances conditional registration - Add option to generate null-safety compatible code to injectableInit ## [1.0.7] - Fix pre-resolved primitives naming issue #161 - Fix some types in readme file - Fix environments is already registered issue. ## [1.0.6] - Support build_runner v1.10.3 ## [1.0.5] - Add support for get_it ^5.0 - Fix analyzer compatibility issues ## [1.0.4] - Add option to customize the initializer function name - Add option to generate the initializer function as an extension - Change initializer functions returns the passed get_it instance instead of void - Add Advanced environment filter that can be extended and customized - Fix Injectable generator not handling multiple instances of generic types #107 ## [1.0.3] - Fix conflict when importing two different types with the same name. - Improve some warning messages ## [1.0.2] - Fix relative imports issue when file has the same path as target ## [1.0.1] Breaking Change - Fix relative imports issue in test folder - Change generateForDir property's default value to ['lib'] ## [1.0.0] Breaking Change - Add support for multi environments (annotation & inlined) - Add generation-time check for duplicate dependencies under the same environment - Fix 3rd party imports from src instead of library file issue - Change generated file extension to .config.dart - Change generated file applies to most of effective dart rules including preferring relative imports - Clean up some code ## [0.4.1] - Fix stack overflow issue #78 ## [0.4.0] Breaking Changes! - Change Methods inside of register modules are treated as factory methods now, so all params are considered injected params unless annotated with @factoryParam. - Change registerModule is now replaced with @module - Change RegisterAs(Type) Annotation is now replaced with @Injectable(as:Type) - Change Singleton.Lazy() is replaced with @LazySingleton() - Add generateForDir property to @InjectableInt to specify what directories to generate for. - Fix imports issue when working with bin directory ## [0.3.5] - Fix non-primitive factory params aren't imported ## [0.3.4] - fix parameterized dependencies aren't resolved properly - minor fixes ## [0.3.3] - fix duplicate var names issue when pre-resolving multiple instances of the same type ## [0.3.2] - fix registered abstract dependencies are reported missing. - fix registering third party types as singleton throws an error. ## [0.3.1] - fix resolve by instanceName is using positional var instead of named - fix part files are imported as stand alone - minor fixes ## [0.3.0] Breaking Changes! - add support for GetIt 4.0.0 - fix generic types are registered as dynamic - fix unresolved future when registering asynchronous dependencies - change asynchronous dependencies will be registered using async factory unless annotated with @preResolve ## [0.2.4] - fix type arguments are not imported. - fix get with instanceName missing type. ## [0.2.3] - improve support for custom initializers - fix src import issue ## [0.2.2] - remove flutter dependency - add support for custom initializers in register Modules - minor fixes ## [0.2.1] - fix typo in @Environment annotation - ignore abstract classes in auto mode. ## [0.2.0] Breaking Changes! - You now need to pass in your getIt instance to @initGetIt() func - Rename @Bind to @RegisterAs to avoid confusion because, now we're annotating the implementation not the abstract. - Add @factoryMethod annotation to mark named factories and static create methods. - Add @registerModule annotation to support registering third party types. - Fix eager singletons are registered before their dependencies. ## [0.1.0] - initial release